This topic explains a sample file containing import parameters and possible values. A sample CSV file is provided in Supported Formats. For detailed information about all supported objects, see Mandatory Parameters, DNS Objects, IPAM/DHCP Objects, and Other objects.
In the following example, we are adding authoritative zones. The following image shows the various parts of the sample CSV file.
The sample CSV file has the following parts:
- Header - The list of header fields in the sample CSV file. Specify values for header fields marked as mandatory. The list of header fields is shown in 9536759.
- Values - Values for the header fields. The values are shown in 9536759.
- Header-ExtraData - The list of Header-ExtraData fields in the sample CSV file. The list of header fields is shown in 9536759.
- ExtraData - Values for the Header-ExtraData fields. Values for ExtraData fields are shown in 9536759.
The following fields are updated with sample values for adding an Authoritative Zone:
- data.items.spec.authZone.fqdn - The FQDN for the Authoritative Zone.
- data.items.spec.authZone.view - The DNS view. The Authoritative Zone is created under the DNS view default.
- data.items.metadata.name - This identifies the view. The format is DNS view name, FQDN.
The following fields tell BloxOne how to interpret the data while importing each entry. The sample values for the following fields are shown in 9536759:
- HEADER-<ObjectName> - in this example, we use authzones.
- data.items.apiVersion - values provided in the table.
- data.items.kind - values provided in the table.
- data.items.mergeOptions.key - the value will always be `key`.
- data.items.mergeOptions.parentKind - values provided in the table.
- data.items.metadata.namespace - specify the namespace as required or leave it as 'default.
- data.items.metadata.resourceVersion
- data.items.metadata.selfLink - in the format `/apis/{api}/{version}/namespaces/{namespace}/{object type}/{view name},{FQDN}`
- data.items.spec.key - in the format DNS view name, FQDN.
Some fields in the following tables are marked as mandatory. Without updating the values for the mandatory fields, the import will fail. Specify the values exactly as per the sample values shown in 9536759.
The following tables provide sample values for the parameters in the sample CSV file. This table primarily focuses on authzones. For detailed information about all supported objects, see Mandatory Parameters, DNS Objects, IPAM/DHCP Objects, and Other objects.
Table 1 - Header-<ObjectName>
Header Fields | Sample Values showing syntax | Mandatory |
---|---|---|
HEADER-authzones | authzones | Yes |
Other possible values based on the object type: | Other possible values based on the corresponding object type in the HEADER field: | |
HEADER-forwardzones | forwardzones | |
HEADER-ipspaces | ipspace | |
HEADER-addressblocks | addressblock | |
HEADER-subnets | subnet | |
HEADER-ranges | range | |
HEADER-fixedaddresses | fixedaddress | |
HEADER-optionspaces | optionspace | |
HEADER-optioncodes | optioncode | |
HEADER-optiongroups | optiongroup | |
HEADER-hardwarefilters | hardwarefilter | |
HEADER-optionfilters | optionfilter | |
HEADER-servers | server | |
HEADER-hagroups | hagroup | |
HEADER-views | view | |
HEADER-authzones | authzone | |
HEADER-forwardzones | forwardzone | |
HEADER-servers | server | |
HEADER-records | records | |
HEADER-keys | keys | |
HEADER-tags | tags | |
HEADER-values | values | |
data.items.apiVersion | `dnsconfig.bulk.infoblox.com/v1` Other possible values based on the object type: DNS Config: `dnsconfig.bulk.infoblox.com/v1` | Yes |
data.items.kind | `AuthZone` Other possible values based on the object type: `AuthZone` | Yes |
data.items.mergeOptions.key | `key` | Yes |
data.items.mergeOptions.parentKind | ["keys.bulk.infoblox.com/tsigkey"," Other possible values based on the object type: For forwardzone: ["dnsconfig.bulk.infoblox.com/view", For servers: ["keys.bulk.infoblox.com/tsigkey", For views: ["keys.bulk.infoblox.com/tsigkey", For records: ["dnsconfig.bulk.infoblox.com/view", For addressblocks: ["ipamdhcp.bulk.infoblox.com/ipspace", For address: ["ipamdhcp.bulk.infoblox.com/ipspace", For fixedaddress: ["ipamdhcp.bulk.infoblox.com/ipspace", | Yes |
data.items.metadata.creationTimestamp | null | No |
data.items.metadata.name | `default,sub03.sub02. sub01.ZTP_new_host_1_875131223245035719.` While adding resource records, a prefix RDATA must be added to the start and end of the rdata component in the format viewname, fqdn, name_in_zone, type, RDATA <rdata> RDATA. For example, dee-view-1,test.,mx2,MX,RDATA{\"preference\":11111,\"exchange\":\"poppy.com\"}RDATA. | Yes |
data.items.metadata.namespace | `default` | Yes |
data.items.metadata.resourceVersion | `1633619583169539000` | No |
data.items.metadata.selfLink | `/apis/dnsconfig.bulk.infoblox.com/v1/ namespaces/default/authzones/default, sub03.sub02.sub01. ZTP_new_host_1_875131223245035719.` | Yes |
data.items.spec.authZone.comment | No | |
data.items.spec.authZone.created_at.nanos | 439628000 | No |
data.items.spec.authZone.created_at.seconds | 1633619576 | No |
data.items.spec.authZone.external_primaries | No | |
data.items.spec.authZone.external_secondaries | No | |
data.items.spec.authZone.fqdn | `sub03.sub02.sub01. ZTP_new_host_1_875131223245035719.` | Yes |
data.items.spec.authZone.id | `dns/auth_zone/07b26eed-4485-414b-b719-2b26f7a262f7` | No |
data.items.spec.authZone. inheritance_sources.gss_tsig_enabled.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.gss_tsig_enabled.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.notify.action | `override` | No |
data.items.spec.authZone. inheritance_sources.query_acl.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.query_acl.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.transfer_acl.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.transfer_acl.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.update_acl.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.update_acl.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.use_ forwarders_for_subzones.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.use_ forwarders_for_subzones.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.default_ttl.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.default_ttl.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.expire.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.expire.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.zone_authority. mname_block.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.mname_block.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.mname_block.value | {} | No |
data.items.spec.authZone. inheritance_sources.zone_ authority.negative_ttl.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources. zone_authority. negative_ttl.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec.authZone. inheritance_sources. zone_authority. protocol_rname.action | `inherit` | No |
data.items.spec.authZone. inheritance_sources. zone_authority. protocol_rname.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.refresh.action | `inherit` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.refresh.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.retry.action | `inherit` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.retry.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.rname.action | `inherit` | No |
data.items.spec. authZone.inheritance_sources. zone_authority.rname.source | `dns/global/fd94b17e-0c64-4eda-b31c-c49a4834258b` | No |
data.items.spec. authZone.initial_soa_serial | 1 | No |
data.items.spec. authZone.internal_secondaries | [{"host":"dns/host/2f04e9fdf58a76ecf34bcd37a47d90c4"}] | No |
data.items.spec. authZone.mapped_subnet | No | |
data.items.spec. authZone.mapping | `forward` | No |
data.items.spec. authZone.nsgs | No | |
data.items.spec. authZone.parent | `dns/auth_zone/78193f14-fd54-46e1-b5b7-bf365ba8c838` | No |
data.items.spec. authZone.primary_type | `cloud` | No |
data.items.spec. authZone.protocol_fqdn | `sub03.sub02.sub01.ZTP_new_host_1_875131223245035719.` | No |
data.items.spec. authZone.updated_at.nanos | 169539000 | No |
data.items.spec. authZone.updated_at.seconds | 1633619583 | No |
data.items.spec. authZone. use_forwarders_for_subzones | TRUE | No |
data.items.spec. authZone.view | `dns/view/default` | Yes |
data.items.spec. authZone. zone_authority.default_ttl | 28800 | No |
data.items.spec. authZone. zone_authority.expire | 2419200 | No |
data.items.spec. authZone. zone_authority.mname | `ns.b1ddi.sub03.sub02.sub01. ZTP_new_host_1_875131223245035719.` | No |
data.items.spec. authZone. zone_authority.negative_ttl | 900 | No |
data.items.spec. authZone. zone_authority.protocol_mname | `ns.b1ddi.sub03.sub02.sub01. ZTP_new_host_1_875131223245035719.` | No |
data.items.spec. authZone. zone_authority.protocol_rname | `hostmaster.sub03.sub02.sub01. ZTP_new_host_1_875131223245035719` | No |
data.items.spec. authZone. zone_authority.refresh | 10800 | No |
data.items.spec. authZone. zone_authority.retry | 3600 | No |
data.items.spec. authZone. zone_authority.rname | `hostmaster@sub03.sub02.sub01. ZTP_new_host_1_875131223245035719` | No |
data.items.spec. authZone.zone_authority. use_default_mname | TRUE | No |
data.items.spec.key | `default,sub03.sub02.sub01. ZTP_new_host_1_875131223245035719.` | Yes |
data.items.status | {} | No |
Table 2 - Header-ExtraData-<ObjectName> and ExtraData-<ObjectName>
After adding the data as specified in the above table, add Header-ExtraData-<ObjectName> and ExtraData-<ObjectName> to the CSV file. You can change authzones to the object type you are importing. For example, if you are importing forward zones, you can modify them to HEADER-ExtraData-forwardzones and ExtraData-forwardzones.
Header Fields | Sample Values showing syntax | Mandatory |
---|---|---|
HEADER-ExtraData-authzones | ExtraData-authzones | Yes |
data.apiVersion | `dnsconfig.bulk.infoblox.com/v1/namespace/default/authzones` Other possible values based on the object type: DNS Config: `dnsconfig.bulk.infoblox.com/v1` | Yes |
data.kind | `AuthZoneList` Other possible values based on the object type: `ForwardZoneList` | Yes |
data.metadata.resourceVersion | `1633619583237403000` | No |
data.metadata.selfLink | `/apis/dnsconfig.bulk.infoblox.com/v1/namespaces/default/authzones` | Yes |