Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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:

  1. 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.
  2. Values - Values for the header fields. The values are shown in 9536759.
  3. Header-ExtraData - The list of Header-ExtraData fields in the sample CSV file. The list of header fields is shown in 9536759.
  4. 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 FieldsSample Values showing syntaxMandatory
HEADER-authzonesauthzonesYes
Other possible values based on the object type:Other possible values based on the corresponding object type in the HEADER field:
HEADER-forwardzonesforwardzones
HEADER-ipspacesipspace
HEADER-addressblocksaddressblock
HEADER-subnetssubnet
HEADER-rangesrange
HEADER-fixedaddressesfixedaddress
HEADER-optionspacesoptionspace
HEADER-optioncodesoptioncode
HEADER-optiongroupsoptiongroup
HEADER-hardwarefiltershardwarefilter
HEADER-optionfiltersoptionfilter
HEADER-serversserver

HEADER-hagroups

hagroup
HEADER-viewsview
HEADER-authzonesauthzone
HEADER-forwardzonesforwardzone
HEADER-serversserver
HEADER-recordsrecords
HEADER-keyskeys
HEADER-tagstags
HEADER-valuesvalues
data.items.apiVersion

`dnsconfig.bulk.infoblox.com/v1`

Other possible values based on the object type:

DNS Config: `dnsconfig.bulk.infoblox.com/v1`
Records: `dnsdata.bulk.infoblox.com/v1`
DHCP/IPAM: `ipamdhcp.bulk.infoblox.com/v1`
TSIG Keys: `keys.bulk.infoblox.com/v1`
Tags: `tagging.bulk.infoblox.com/v1alpha1`
Values: `tagging.bulk.infoblox.com/v1alpha1`

Yes
data.items.kind

`AuthZone`

Other possible values based on the object type:

`AuthZone`
`ForwardZone`
`Server`
`View`
`Record`
`Address`
`FixedAddress`
`OptionCode`
`OptionFilter`
`OptionGroup`
`Range`
`TSIGKey`
`Tag`
`Value`


Yes
data.items.mergeOptions.key`key`Yes
data.items.mergeOptions.parentKind

["keys.bulk.infoblox.com/tsigkey","
dnsconfig.bulk.infoblox.com/acl",
"dnsconfig.bulk.infoblox.com/view",
"dnsconfig.bulk.infoblox.com/authnsg",
"dnsconfig.bulk.infoblox.com/forwardnsg"]

Other possible values based on the object type:

For forwardzone:

["dnsconfig.bulk.infoblox.com/view",
"dnsconfig.bulk.infoblox.com/forwardnsg"]

For servers:

["keys.bulk.infoblox.com/tsigkey",
"dnsconfig.bulk.infoblox.com/acl"]

For views:

["keys.bulk.infoblox.com/tsigkey",
"dnsconfig.bulk.infoblox.com/acl",
"ipamdhcp.bulk.infoblox.com/ipspace"]

For records:

["dnsconfig.bulk.infoblox.com/view",
"dnsconfig.bulk.infoblox.com/auth_zone",
"dnsconfig.bulk.infoblox.com/forward_zone"]

For addressblocks:

["ipamdhcp.bulk.infoblox.com/ipspace",
"ipamdhcp.bulk.infoblox.com/optionspace",
"ipamdhcp.bulk.infoblox.com/optioncode",
"ipamdhcp.bulk.infoblox.com/optiongroup",
"ipamdhcp.bulk.infoblox.com/optionfilter",
"ipamdhcp.bulk.infoblox.com/hardwarefilter"]

For address:

["ipamdhcp.bulk.infoblox.com/ipspace",
"ipamdhcp.bulk.infoblox.com/subnet"]

For fixedaddress:

["ipamdhcp.bulk.infoblox.com/ipspace",
"ipamdhcp.bulk.infoblox.com/subnet",
"ipamdhcp.bulk.infoblox.com/optionspace",
"ipamdhcp.bulk.infoblox.com/optioncode",
"ipamdhcp.bulk.infoblox.com/optiongroup"]

Yes
data.items.metadata.creationTimestampnullNo
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.nanos439628000No
data.items.spec.authZone.created_at.seconds1633619576No
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		1No
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		169539000No
data.items.spec.
authZone.updated_at.seconds		1633619583No
data.items.spec.
authZone.
use_forwarders_for_subzones		TRUENo
data.items.spec.
authZone.view		`dns/view/default`Yes
data.items.spec.
authZone.
zone_authority.default_ttl		28800No
data.items.spec.
authZone.
zone_authority.expire		2419200No
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		900No
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		10800No
data.items.spec.
authZone.
zone_authority.retry		3600No
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		TRUENo
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 FieldsSample Values showing syntaxMandatory
HEADER-ExtraData-authzonesExtraData-authzonesYes
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`
Records: `dnsdata.bulk.infoblox.com/v1`
DHCP/IPAM: `ipamdhcp.bulk.infoblox.com/v1`
TSIG Keys: `keys.bulk.infoblox.com/v1`
Tags: `tagging.bulk.infoblox.com/v1alpha1`
Values: `tagging.bulk.infoblox.com/v1alpha1`

Yes
data.kind

`AuthZoneList`

Other possible values based on the object type:

`ForwardZoneList`
`ServerList`
`ViewList`
`RecordList`
`AddressBlockList`
`AddressList`
`FixedAddressList`
`IPSpaceList`
`OptionCodeList`
`OptionGroupList`
`OptionSpaceList`
`RangeList`
`ServerList`
`SubnetList`
`TSIGKeyList`
`TagList`
`ValueList`

Yes
data.metadata.resourceVersion`1633619583237403000`No
data.metadata.selfLink`/apis/dnsconfig.bulk.infoblox.com/v1/namespaces/default/authzones`Yes
  • No labels