Instead of a local name server, remote name servers (which the local server knows) maintain delegated zone data. When the local name server receives a query for a delegated zone, it either responds with the NS record for the delegated zone server (if recursion is disabled on the local server) or it queries the delegated zone server on behalf of the resolver (if recursion is enabled).
You can delegate a zone to one or more remote name servers, which are typically the authoritative primary and secondary servers for the zone. If recursion is enabled on the local name server, it queries multiple delegated name servers based on their round-trip times.
References to zone_delegated are object references. The name part of a DNS Delegated Zone object reference has the following components:
- FQDN of the zone
- Name of the view
Example: zone_delegated/ZG5zLmhvc3QkLZhd3QuaDE:zone.com/default
The object does not support the following operations:
The object cannot be managed on Cloud Platform members.
These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.
The basic version of the object contains the field(s): delegate_to, fqdn, view.
The following fields are required to create this object:
| Field | Notes |
|---|---|
| delegate_to | |
| fqdn |
The IP address of the server that is serving this zone.
Type
String.
Search
The field is not available for search.
Notes
The address cannot be updated.
address cannot be written.
Comment for the zone; maximum 256 characters.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is empty.
Search
The field is available for search via
This provides information for the remote name server that maintains data for the delegated zone. The Infoblox appliance redirects queries for data for the delegated zone to this remote name server.
Type
A/An External Server struct array.
Create
The field is required on creation.
Search
The field is not available for search.
Notes
The delegate_to is part of the base object.
You can specify the Time to Live (TTL) values of auto-generated NS and glue records for a delegated zone. This value is the number of seconds that data is cached.
Type
Unsigned integer.
Create
The default value is empty.
Search
The field is not available for search.
Notes
delegated_ttl is associated with the field use_delegated_ttl (see use flag).
Determines whether a zone is disabled or not. When this is set to False, the zone is enabled.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
The displayed name of the DNS zone.
Type
String.
Search
The field is not available for search.
Notes
The display_domain cannot be updated.
display_domain cannot be written.
The name of this DNS zone in punycode format. For a reverse zone, this is in “address/cidr” format. For other zones, this is in FQDN format in punycode format.
Type
String.
Search
The field is not available for search.
Notes
The dns_fqdn cannot be updated.
dns_fqdn cannot be written.
This flag controls whether automatic generation of RFC 2317 CNAMEs for delegated reverse zones overwrite existing PTR records. The default behavior is to overwrite all the existing records in the range; this corresponds to “allow_ptr_creation_in_parent” set to False. However, when this flag is set to True the existing PTR records are not overwritten.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
Extensible attributes associated with the object.
For valid values for extensible attributes, see the following information.
Type
Extensible attributes.
This field allows +/- to be specified as part of the field name when updating the object, see the following information.
Create
The default value is empty.
Search
For how to search extensible attributes, see the following information.
The name of this DNS zone. For a reverse zone, this is in “address/cidr” format. For other zones, this is in FQDN format. This value can be in unicode format.
Note that for a reverse zone, the corresponding zone_format value should be set.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The field is required on creation.
Search
The field is available for search via
Notes
The fqdn is part of the base object.
The fqdn cannot be updated.
If you enable this flag, other administrators cannot make conflicting changes. This is for administration purposes only. The zone will continue to serve DNS data even when it is locked.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
The name of a superuser or the administrator who locked this zone.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The locked_by cannot be updated.
locked_by cannot be written.
IPv4 Netmask or IPv6 prefix for this zone.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The mask_prefix cannot be updated.
mask_prefix cannot be written.
The flag that determines whether Active Directory is integrated or not. This field is valid only when ms_managed is “STUB”, “AUTH_PRIMARY”, or “AUTH_BOTH”.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
Determines whether an Active Directory-integrated zone with a Microsoft DNS server as primary allows dynamic updates. Valid values are:
“SECURE” if the zone allows secure updates only.
“NONE” if the zone forbids dynamic updates.
“ANY” if the zone accepts both secure and nonsecure updates.
This field is valid only if ms_managed is either “AUTH_PRIMARY” or “AUTH_BOTH”. If the flag ms_ad_integrated is false, the value “SECURE” is not allowed.
Type
String.
Create
The default value is NONE.
Search
The field is not available for search.
The flag that indicates whether the zone is assigned to a Microsoft DNS server. This flag returns the authoritative name server type of the Microsoft DNS server. Valid values are:
“NONE” if the zone is not assigned to any Microsoft DNS server.
“STUB” if the zone is assigned to a Microsoft DNS server as a stub zone.
“AUTH_PRIMARY” if only the primary server of the zone is a Microsoft DNS server.
“AUTH_SECONDARY” if only the secondary server of the zone is a Microsoft DNS server.
“AUTH_BOTH” if both the primary and secondary servers of the zone are Microsoft DNS servers.
Type
String.
Search
The field is not available for search.
Notes
The ms_managed cannot be updated.
ms_managed cannot be written.
Determines if a Grid member manages the zone served by a Microsoft DNS server in read-only mode. This flag is true when a Grid member manages the zone in read-only mode, false otherwise.
When the zone has the ms_read_only flag set to True, no changes can be made to this zone.
Type
Bool.
Search
The field is not available for search.
Notes
The ms_read_only cannot be updated.
ms_read_only cannot be written.
The name of MS synchronization master for this zone.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The ms_sync_master_name cannot be updated.
ms_sync_master_name cannot be written.
The delegation NS group bound with delegated zone.
Type
String.
Create
The default value is empty.
Search
The field is not available for search.
The parent zone of this zone.
Note that when searching for reverse zones, the “in-addr.arpa” notation should be used.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is available for search via
Notes
The parent cannot be updated.
parent cannot be written.
The RFC2317 prefix value of this DNS zone.
Use this field only when the netmask is greater than 24 bits; that is, for a mask between 25 and 31 bits. Enter a prefix, such as the name of the allocated address block. The prefix can be alphanumeric characters, such as 128/26 , 128-189 , or sub-B.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is empty.
Search
The field is not available for search.
Use flag for: delegated_ttl
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
This is true if the zone is associated with a shared record group.
Type
Bool.
Search
The field is not available for search.
Notes
The using_srg_associations cannot be updated.
using_srg_associations cannot be written.
The name of the DNS view in which the zone resides. Example “external”.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is The default DNS view.
Search
The field is available for search via
Notes
The view is part of the base object.
This function is used to lock or unlock zone to prevent other administrators from making conflicting changes.
This function does not support multiple object matches when called as part of an atomic insertion operation.
Input fields
operation ( String. Valid values are: “LOCK”, “UNLOCK” ). This parameter is mandatory. The operation to perform.
Output fields
None
| Field | Type | Req | R/O | Base | Search |
|---|---|---|---|---|---|
| address | String | N | Y | N | N/A |
| comment | String | N | N | N | : = ~ |
| delegate_to | [struct] | Y | N | Y | N/A |
| delegated_ttl | Unsigned int | N | N | N | N/A |
| disable | Bool | N | N | N | N/A |
| display_domain | String | N | Y | N | N/A |
| dns_fqdn | String | N | Y | N | N/A |
| enable_rfc2317_exclusion | Bool | N | N | N | N/A |
| extattrs | Extattr | N | N | N | ext |
| fqdn | String | Y | N | Y | = ~ |
| locked | Bool | N | N | N | N/A |
| locked_by | String | N | Y | N | N/A |
| mask_prefix | String | N | Y | N | N/A |
| ms_ad_integrated | Bool | N | N | N | N/A |
| ms_ddns_mode | String | N | N | N | N/A |
| ms_managed | String | N | Y | N | N/A |
| ms_read_only | Bool | N | Y | N | N/A |
| ms_sync_master_name | String | N | Y | N | N/A |
| ns_group | String | N | N | N | N/A |
| parent | String | N | Y | N | = |
| prefix | String | N | N | N | N/A |
| use_delegated_ttl | Bool | N | N | N | N/A |
| using_srg_associations | Bool | N | Y | N | N/A |
| view | String | N | N | Y | = |
| zone_format | String | N | N | N | = |
