---
title: "servers"
canonical: "https://docs.infoblox.com/space/BloxOneCloud/52036874/servers"
format: markdown
---
Mandatory parameters are denoted by an * (asterisk).

| header | type | description | required | encoding | sample | object_headers |  |  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| HEADER-dnsconfig-v2-server* | string | The primary identifier of the header stating the type of object. | TRUE | string |  |  |  |  |  |  |  |  |  |  |  |
| key* | string | The primary identifier of an individual object. For Server, name is used as key. | TRUE | string |  |  |  |  |  |  |  |  |  |  |  |
| name | string | The name of the DHCP Config Profile. Must contain 1 to 256 characters. Can include UTF-8. | TRUE | string |  |  |  |  |  |  |  |  |  |  |  |
| comment | string | The description for the DHCP Config Profile. May contain 0 to 1024 characters. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| lease_time_v6 | integer | The lease duration in seconds for IPV6 clients. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| filters_v6 | array | The list of IPv6 filters assigned to a scope. A client will receive the union of all options from all filters it matches. | FALSE | stringarray |  |  |  |  |  |  |  |  |  |  |  |
| allow_unknown | boolean | Disable to allow leases only for known IPv4 clients, those for which a fixed address is configured. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| filters | array | The list of IPv4 filters assigned to a scope. A client will receive the union of all options from all filters it matches. | FALSE | stringarray |  |  |  |  |  |  |  |  |  |  |  |
| lease_time | integer | The lease duration in seconds for IPv4. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ignore_client_uid | boolean | Enable to ignore the client UID when issuing a DHCP lease. Use this option to prevent assigning two IP addresses for a client which does not have a UID during one phase of PXE boot but acquires one for the other phase. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ignore_list | array | The list of clients to ignore requests from. | FALSE | nios |  | ignore_item_type | ignore_item_value |  |  |  |  |  |  |  |  |
| allow_unknown_v6 | boolean | Disable to allow leases only for known IPv6 clients, those for which a fixed address is configured. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| dhcp_options | string | The list of DHCP options or group of options for IPv4.  
An option list is ordered and may include both option groups and specific options.  
Multiple occurences of the same option or group is not an error.  
The last occurence of an option in the list will be used. | FALSE | expanddhcp |  |  |  |  |  |  |  |  |  |  |  |
| dhcp_options_v6 | string | The list of DHCP options or group of options for IPv6.  
An option list is ordered and may include both option groups and specific options.  
Multiple occurences of the same option or group is not an error.  
The last occurence of an option in the list will be used. | FALSE | expanddhcp |  |  |  |  |  |  |  |  |  |  |  |
| ddns_enabled | boolean | Indicates if DDNS updates should be performed for leases.  
All other ddns_*_ configuration is ignored when this flag is unset.  
At a minimum, ddns_domain and ddns_zones must be configured to enable DDNS. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_domain | string | The domain suffix for DDNS updates. FQDN, may be empty. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_zones | array | The DNS zones that DDNS updates can be sent to.  
There is no resolver fallback. The target zone must be explicitly configured for the update to be performed.  
Updates are sent to the closest enclosing zone.  
Error if ddns_enabled is true and the ddns_domain does not have a corresponding entry in ddns_zones.  
Error if there are items with duplicate zone in the list. | FALSE | nios |  | zone | fqdn | tsig_enabled | tsig_key | tsig_name | tsig_comment | tsig_algorithm | tsig_secret | gss_tsig_enabled | nameservers |
| ddns_generate_name | boolean | Indicates if DDNS needs to generate a hostname when not supplied by the client. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_client_update | string | Controls who does the DDNS updates.  
Valid values are:<br>- client: DHCP server updates DNS if requested by client.
- server: DHCP server always updates DNS, overriding an update request from the client, unless the client requests no updates.
- ignore: DHCP server always updates DNS, even if the client says not to.
- over_client_update: Same as server. DHCP server always updates DNS, overriding an update request from the client, unless the client requests no updates.
- over_no_update: DHCP server updates DNS even if the client requests that no updates be done. If the client requests to do the update, DHCP server allows it. | FALSE | string | client |  |  |  |  |  |  |  |  |  |  |
| hostname_rewrite_enabled | boolean | Indicates if client supplied hostnames will be rewritten prior to DDNS update by replacing every character that does not match hostname_rewrite_regex by hostname_rewrite_char. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| hostname_rewrite_regex | string | The regex bracket expression to match valid characters.  
Must begin with '[' and end with ']' and be a compilable POSIX regex. | FALSE | string | [^a-zA-Z0-9_.] |  |  |  |  |  |  |  |  |  |  |
| hostname_rewrite_char | string | The character to replace non-matching characters with, when hostname rewrite is enabled.  
Any single ASCII character or no character if the invalid characters should be removed without replacement. | FALSE | string | - |  |  |  |  |  |  |  |  |  |  |
| allow_unknown_action | string | The inheritance configuration for allow_unknown field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| filters_action | string | The inheritance configuration for filters field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| lease_time_action | string | The inheritance configuration for lease_time field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ignore_client_uid_action | string | The inheritance configuration for ignore_client_uid field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ignore_list_action | string | The inheritance configuration for ignore_list field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| allow_unknown_v6_action | string | The inheritance configuration for allow_unknown_v6 field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| lease_time_v6_action | string | The inheritance configuration for lease_time_v6 field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| filters_v6_action | string | The inheritance configuration for filters_v6 field from DHCPConfig object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| dhcp_options_v4_value | array | The inheritance configuration for a field of type of OptionItem. | FALSE | nios |  | dhcp_options_value_action |  |  |  |  |  |  |  |  |  |
| dhcp_options_v4_action | string | The inheritance setting.  
Valid values are:<br>- inherit: Use the inherited value.
- block: Don't use the inherited value.<br>Defaults to inherit. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| dhcp_options_v6_action | string | The inheritance setting.  
Valid values are:<br>- inherit: Use the inherited value.
- block: Don't use the inherited value.<br>Defaults to inherit. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| dhcp_options_v6_value | array | The inheritance configuration for a field of type of OptionItem. | FALSE | nios |  | dhcp_options_value_action |  |  |  |  |  |  |  |  |  |
| ddns_block_action | string | The inheritance configuration for ddns_block field from Server object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| vendor_specific_option_option_space_action | string | The reference to the option space that will be encapsulated into the vendor specific option (code = 43). | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| header_option_server_address_action | string | The inheritance configuration for header_option_server_address field. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| header_option_server_name_action | string | The inheritance configuration for header_option_server_name field. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| header_option_filename_action | string | The inheritance configuration for header_option_filename field. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ddns_client_update_action | string | The inheritance configuration for ddns_client_update field from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| hostname_rewrite_block_action | string | The inheritance configuration for hostname_rewrite_enabled, hostname_rewrite_regex, and hostname_rewrite_char fields from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ddns_hostname_block_action | string | The inheritance configuration for ddns_generate_name and ddns_generated_prefix fields from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ddns_update_on_renew_action | string | The inheritance configuration for ddns_update_on_renew field from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ddns_use_conflict_resolution_action | string | The inheritance configuration for ddns_use_conflict_resolution field from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| ddns_conflict_resolution_mode_action | string | The inheritance configuration for ddns_conflict_resolution_mode field from DHCP Config Profile object. | FALSE | string | inherit |  |  |  |  |  |  |  |  |  |  |
| tags | string | The tags for the DHCP Config Profile in JSON format. | FALSE | expandtags | {} |  |  |  |  |  |  |  |  |  |  |
| vendor_specific_option_option_space | string | The reference to the option space that will be encapsulated into the vendor specific option (code = 43). | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| header_option_server_address | string | The configuration for header option server address field. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| header_option_server_name | string | The configuration for header option server name field. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| header_option_filename | string | The configuration for header option filename field. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_send_updates | boolean | Determines if DDNS updates are enabled at the server level. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_generated_prefix | string | The prefix used in the generation of an FQDN.  
When generating a name, DHCP server will construct the name in the format: [ddns-generated-prefix]-[address-text].[ddns-qualifying-suffix].  
where address-text is simply the lease IP address converted to a hyphenated string. | FALSE | string | myhost |  |  |  |  |  |  |  |  |  |  |
| ddns_update_on_renew | boolean | Instructs the DHCP server to always update the DNS information when a lease is renewed even if its DNS information has not changed. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_use_conflict_resolution | boolean | When true, DHCP server will apply conflict resolution, as described in RFC 4703, when attempting to fulfill the update request.  
When false, DHCP server will simply attempt to update the DNS entries per the request, regardless of whether or not they conflict with existing entries owned by other DHCP4 clients. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| client_principal | string | The Kerberos principal name. It uses the typical Kerberos notation: <SERVICE-NAME>/<server-domain-name>@<REALM>. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| server_principal | string | The Kerberos principal name of this DNS server that will receive updates. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_kdc | string | Address of Kerberos Key Distribution Center. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_keys | array | _kerberos_keys contains a list of keys for GSS-TSIG signed dynamic updates. | FALSE | stringarray |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_tkey_lifetime | integer | Lifetime (in seconds) of GSS-TSIG keys in the TKEY protocol. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_rekey_interval | integer | Time interval (in seconds) the keys for each configured external DNS server are checked for rekeying, i.e. a new key is created to replace the current usable one when its age is greater than the kerberos_rekey_interval value. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_retry_interval | integer | Retry Time interval (in seconds)to create a key if any error occurred previously for any configured external DNS server. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| kerberos_tkey_protocol | string | Determines which protocol is used to establish the security context with the external DNS servers, TCP or UDP. | FALSE | string | tcp |  |  |  |  |  |  |  |  |  |  |
| gss_tsig_fallback | boolean | The behavior when GSS-TSIG should be used (a matching external DNS server is configured) but no GSS-TSIG key is available.  
If configured to false (the default) this DNS server is skipped, if configured to true the DNS server is ignored and the DNS update is sent with the configured DHCP-DDNS protection e.g. TSIG key or without any protection when none was configured. | FALSE | string |  |  |  |  |  |  |  |  |  |  |  |
| ddns_conflict_resolution_mode | string | The mode used for resolving conflicts while performing DDNS updates.  
Valid values are:<br>- check_with_dhcid: It includes adding a DHCID record and checking that record via conflict detection as per RFC 4703.
- no_check_with_dhcid: This will ignore conflict detection but add a DHCID record when creating/updating an entry.
- check_exists_with_dhcid: This will check if there is an existing DHCID record but does not verify the value of the record matches the update. This will also update the DHCID record for the entry.
- no_check_without_dhcid: This ignores conflict detection and will not add a DHCID record when creating/updating a DDNS entry. | FALSE | string | check_with_dhcid |  |  |  |  |  |  |  |  |  |  |