servers
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. | FALSE | expanddhcp |
|
|
|
|
|
|
|
|
|
|
|
dhcp_options_v6 | string | The list of DHCP options or group of options for IPv6. | FALSE | expanddhcp |
|
|
|
|
|
|
|
|
|
|
|
ddns_enabled | boolean | Indicates if DDNS updates should be performed for leases. | 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. | 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.
| 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. | FALSE | string | [^a-zA-Z0-9_.] |
|
|
|
|
|
|
|
|
|
|
hostname_rewrite_char | string | The character to replace non-matching characters with, when hostname rewrite is enabled. | 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.
Defaults to inherit. | FALSE | string | inherit |
|
|
|
|
|
|
|
|
|
|
dhcp_options_v6_action | string | The inheritance setting.
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. | 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. | 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. | FALSE | string |
|
|
|
|
|
|
|
|
|
|
|
ddns_conflict_resolution_mode | string | The mode used for resolving conflicts while performing DDNS updates.
| FALSE | string | check_with_dhcid |
|
|
|
|
|
|
|
|
|
|