---
title: "Stub Zone"
canonical: "https://docs.infoblox.com/space/NCR8/23068755/Stub%20Zone"
format: markdown
---
| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-StubZone | String | Yes |  |  | Identifies the first row as a header row for the stub zones. Example: StubZone |
| fqdn | FQDN | Yes | Name | zone | This field combines the AAAA record name and the zone name to form the FQDN. Example: aaaa1.corp100.com |
| view | String | No | DNS View | views | If no view is specified, the default view is used. Example: Default |
| zone_format | String | Yes | Type |  | Valid values are **FORWARD**, **IPV4**,and **IPV6**. |
| prefix | String | No | RFC 2317   
 Prefix | prefix | Prefix is used for reverse-mapping RFC2317 zones only. If you include a prefix in a forward-mapping zone, the appliance ignores the prefix. No error message is generated. |
| disabled | Boolean | No | Disable | disable | Enable or disable the stub zone. Example: FALSE |
| comment | String | No | Comment | comment | Example: This is a stub zone. |
| disable_forwarding | Boolean | No | Do not use forwarders | disable_forwarding | Enable or disable forwarding. Example: False |
| stub_from | Master Nameserver list | Yes |  |  | List of external stub servers. Example: "nm1.test.com/2.2.2.2,..." |
| stub_members | Member server list | No |  |  | List of stub Grid members. |
| ns_group | String | No |  | ns_group | Stub member name server group name. Example: stub_ns_group1. |
| ns_group_external | String | No |  | external_ns_group | Forward/Stub server name server group name. Example: ext_ns_group1. |
| EA-Site | String | No | Extensible attribute | extensible_attributes | EA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. Example: California. |
| EA-Users | List | No | Extensible attribute | extensible_attributes | EA-Users is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: [‘Annie’, ‘John’]. |
| ADMGRP-XXXX | String | No | Permissions Admin Group/Role | permission | ADMGRP-JimSmith is an example of an admin permission of a specific admin group.   
 Example: RW |

  
 > Macro (anchor)

 > Macro (anchor)

 **Delegated** **Zone**

| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-DelegatedZone | String | Yes |  |  | Identifies the first row as a header row for delegated zones. Example: DelegatedZone |
| fqdn | FQDN | Yes | Name | zone | This field combines the AAAA record name and the zone name to form the FQDN. Example: aaaa1.corp100.com |
| view | String | No | DNS View | views | If no view is specified, the default view is used. Example: Default |
| zone_format | String | Yes | Type |  | Valid values are **FORWARD**, **IPV4**,and **IPV6**. |
| prefix | String | No | RFC 2317   
 Prefix | prefix | Prefix is used for reverse-mapping RFC2317 zones only. If you include a prefix in a forward-mapping zone, the appliance ignores the prefix. No error message is generated. |
| disabled | Boolean | No | Disable | disable | Enable or disable the zone. Example: FALSE |
| comment | String | No | Comment | comment | Example: Delegated zone header. |
| delegate_to | Delegated Servers list | Yes |  |  | Example: delegate_server1.test.com/1.1.1.1/, |
| delegated_ttl | Unsigned integer | No |  |  | This is an inherited field. Example: 28800 |
| EA-Site | String | No | Extensible attribute | extensible_attributes | EA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. Example: California. |
| EA-Users | List | No | Extensible attribute | extensible_attributes | EA-Users is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: ['Annie', 'John']. |
| ADMGRP-XXXX | String | No | Permissions Admin Group/Role | permission | ADMGRP-JimSmith is an example of an admin permission of a specific admin group. Example: RW |
| ns_group | String | No | Name server group | ns_group | Authoritative name server group name. Example: name-ns-group1 |
| _new_prefix | String | No |  |  | Add this field to overwrite the prefix field when you select the Overwrite or Merge option. Use the host name of the Grid member in this field.<br>Example: infoblox.localdomain |
| <span style="color: #333333">ddns_protected</span> | <span style="color: #000000">Boolean</span> | No | Protected |  | <span style="color: #000000">Add this field </span>in order to restrict DDNS updates to record. |
| <span style="color: #000000">ddns_principal</span> | String | No | Principal |  | <span style="color: #000000">Displays the principal name for dynamic records with the GSS-TSIG principal authentication enabled in the advanced updates properties of the Grid, view, zone, or Standalone. </span> |

  
 > Macro (anchor)

 > Macro (anchor)

 **Authoritative** **Name** **Server** **Group**

| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-NsGroup | String | Yes |  |  | Identifies the first row as a header row for the authoritative name server group objects.   
 Example: AuthoritativeNsGroup. |
| group_name | String | Yes |  |  | Indicates the name of the authoritative name server group. Example: ns_group1 |
| _new_group_name | String | No |  |  | You can overwrite the group name. |
| grid_primaries | Grid member list and stealth state | No | Grid Primary/ Stealth | primary stealth | List of primary servers of the name server group. The valid format is: "hostname/stealth"   
 Example: "foo.localadmin/False,corp1.com/True,..." |
| external_primaries | Server list | No | External Primary | primary | List of external primary servers. The valid format is: name/ip/stealth/use_2x_tsig/use_tsig/ tsig_name/tsig_key. Only name and IP address are required. If **stealth** is not specified, **use_2x_tsig** and **use_tsig** are used and the default value is set to **False** . Example: "ext1.test.com/1.1.1.1/FALSE,.." |
| external_secondaries | Server list | No | External Secondary | secondaries | List of external secondary servers. The valid format is: name/ip/stealth/use_2x_tsig/use_tsig/tsig_ name/tsig_key. Only name and IP address are required. Default values are assumed for **stealth**, **use_2x_tsig** and **use_tsig**. If either **use_2x_tsig** or **use_tsig** is **True**, then **tsig_name** and **tsig_key** are required.   
 Example: "sec1.com/1.1.1.1/FALSE/FALSE/FALSE/foo/ sdfsdf86ew,.." |
| grid_secondaries | Member server list | No | Grid Secondary | secondaries | List of Grid secondary servers. The valid format is: hostname/stealth/lead/grid_replicate.   
 Only hostname is required. The appliance assumes default value for **stealth.** Values are not specified for **lead** and **grid_replicate** fields. Example: "member1.localdomain/FALSE/TRUE/FALSE," |
| is_grid_default | Boolean | No |  |  | Set this to **True** to set this name server group as Grid default, set to **False** to unset this name server group as Grid default. Example: False |
| comment | String | No | Comment | comment | Example: This is a authoritative name server group. |
| EA-Site | String | No | Extensible attribute | extensible_attributes | EA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. Example: California. |
| EA-Users | String | No | Extensible attribute | extensible_attributes | EA-Users is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: John. |

  
 > Macro (anchor)

 > Macro (anchor)

 **Forwarding** **Member** **Name** **Server** **Group**

| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-ForwardingM emberNsGroup | String | Yes |  |  | Identifies the first row as a header row for the forwarding member name server group objects. Example: ForwardingMemberNsGroup. |
| group_name | String | Yes | Name | name | Indicates the name of the forwarding member name server group. Example: fwd_ns_group1 |
| _new_group_name | String | No |  |  | You can overwrite the group name. |
| comment | String | No | Comment | comment | Example: This is a forwarding member name server group. |
| forwarding_servers | Forwarding members list | Yes |  | forwarding_servers | List of forwarding servers. Example: infoblox.localdomain. |
| EA-XXX | String | No | Extensible attribute | extensible_attributes | EA-XXX is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: John. |

> Macro (anchor)

 > Macro (anchor)

 **Stub** **Member** **Name** **Server** **Group**

| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-StubMember NsGroup | String | Yes |  |  | Identifies the first row as a header row for the stub member name server group objects.   
 Example: StubMemberNsGroup. |
| group_name | String | Yes | Name | name | Indicates the name of the stub member name server group. Example: stub_ns_group1 |
| _new_group_name | String | No |  |  | You can overwrite the group name. |
| comment | String | No | Comment | comment | Example: This is a stub member name server group. |
| stub_members | Member server list | Yes |  | stub_members | List of stub Grid members. |
| EA-XXX | String | No | Extensible attribute | extensible_attributes | EA-XXX is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: John. |

  
 > Macro (anchor)

 > Macro (anchor)

 **Forward/Stub** **Server** **Name** **Server** **Group**

| **Field**** ****Name** | **Data**** ****Type** | **Required**** ****(Yes/No)** | **Associated**** ****GUI**** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-ForwardStub ServerNsGroup | String | Yes |  |  | Identifies the first row as a header row for the forward/stub server name server group objects. Example: ForwardStubServerNsGroup. |
| group_name | String | Yes | Name | name | Indicates the name of the forward/stub server name server group. Example: ext_ns_group1 |
| _new_group_name | String | No |  |  | You can overwrite the group name. |
| comment | String | No | Comment | comment | Example: This is a forward/stub server name server group. |
| external_servers | External server list | Yes |  | external_servers | List of external servers. |
| EA-XXX | String | No | Extensible attribute | extensible_attributes | EA-XXX is an example of a user defined attribute. You can add other user defined attributes to the data file. Example: John. |

  
 > Macro (anchor)

 > Macro (anchor)

 **A** **Record**

---

**Note:** IDN is supported for object type: fqdn. You can use IDN or punycode while importing this object.

---

| **Field**** ****Name** | **Data**** ****Type ** | **Required**** ****(Yes/No)** | **Associated**** ****GUI **** ****Field** | **Associated**** ****PAPI**** ****Method** | **Usage**** ****and**** ****Guidelines** |
| --- | --- | --- | --- | --- | --- |
| Header-ARecord | String | Yes |  |  | Example: ARecord |
| fqdn | FQDN | Yes | Name | name | This field combines the A record name and the zone name to form the FQDN.  
Example: [a1.corp100.com](http://a1.corp100.com) |
| _new_fqdn | FQDN | No |  |  | Add this field to overwrite the fqdn field when you select the overwrite or merge option. |
| view | String | No | DNS View | views | If no view is specified, the Default view is used. |
| address | IP address | Yes | IP Address | ipv4addrss | Example: 192.138.1.1 |
| _new_address | IP address | No |  |  | Add this field to overwrite the address field when you select the overwrite or merge option. |
| comment | String | No | Comment | comment |  |
| disabled | Boolean | No | Disable | disable | Example: FALSE |
| ttl | Unsigned integer | No | TTL | ttl | This is an inherited field. For information, see [ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Data](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Specific](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Guidelines](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*. Example: 7200 |
| EA-Site | String | No | Extensible attribute Site | extensible_attributes | EA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. For information about data format and examples, see [ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Data](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Specific](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Guidelines](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[.](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span> |
| EA-Users | List | No | Extensible attribute Users | extensible_attributes | EA-Users is an example of a user defined attribute. You can add other user defined attributes to the data file. For information about data format and examples, see *<span style="color: #0000ff">[Data](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Specific](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Guidelines](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*. |
| ADMGRP-JoeSmith | String | No | Permissions   
Admin  
 Group/Role | permission | ADMGRP-JoeSmith is an example of an admin permission of a specific admin group. For information about data format and examples, see [ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Data](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Specific](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798) [ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)<span style="color: #0000ff">[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*<span style="color: #0000ff">[Guidelines](https://infoblox-docs.atlassian.net/wiki/spaces/NCR8/pages/23068798)</span>*. |


# Examples

This section contains examples of how to create data files for A records. All examples use comma as the separator. You can use other supported separators, such as semicolon, space, or tab.

## Adding an A Record

This example shows how to add an A record, bind_a.corp100.com, with the extensible attribute Site = Infoblox, and the permission, DNS_Admins = RO.

`header-arecord,address*,fqdn*,ADMGRP-DNS_Admins,EA-Site arecord,100.0.0.1,bind_a.corp100.com,RO,Infoblox`

## Overwriting A Record Data

This example shows how to modify the permission of the admin group DNS_Admins from RO to DENY in an existing A record, bind_a.corp100.com.

`header-arecord,address*,fqdn*,ADMGRP-DNS_Admins arecord,100.0.0.1,bind_a.corp100.com,DENY`

## Merging DNS Zone Data

This example shows how to merge the TTL value = 1280 to an existing A record, bind_a.corp100.com.

`header-arecord,address*,fqdn*,ttl arecord,100.0.0.1,bind_a.corp100.com,1280`