Zones are called Domains in our web interface.

axfr-ips

A comma-separated list of IPs or IP blocks allowed to perform AXFRs for this domain. Only valid for master/primary domains and if restrict-axfr is enabled. (optional; read/write)

created-at

Initial creation time of this resource. (readonly)

custom-nameservers

A comma-separated list of custom nameservers. If nil, the domain will use Zerigo’s default list of servers. Only valid for domains with custom-ns enabled. (optional; read/write)

custom-ns

Indicates if vanity (custom) nameservers are enabled for this domain. Only allowed if the account’s service plan supports vanity nameservers. (optional; read/write)

default-ttl

Default TTL (time-to-live), in seconds, for host records attached to this zone. (required; read/write)

domain

The domain name (required; read/write)

follow-template

One of ‘no’ or ‘follow’. When ‘follow’, will inherit changes from the associated Zone Template. When ‘no’ and a zone_template_id is present, will copy once from that Zone Template (and then clear zone_template_id). (optional; read/write)

hostmaster

The email of the DNS administrator or hostmaster. A nil value will default to Zerigo’s hostmaster address. Note that this is publicly visible in the domain records. Only valid for domains with custom-ns enabled. (optional; read/write)

hosts

An array of host records. See Hosts. (readonly)

hosts-count

Total number of hosts that belong to this zone. (readonly)

id

Unique ID for this zone. (readonly)

notes

Notes about the domain. (optional; read/write)

ns1

The remote master nameserver, required when ns-type is ‘sec’. (read/write)

ns-type

Three valid values: ‘pri_sec’, ‘pri’, and ‘sec’ which are: Standard service (normal), Standard service with Master support, and Slave only service respectively.

The value of ns-type will determine whether ns1 or slave-nameservers are used. If ns-type is ‘pri’, then slave-nameservers should be used to provide a comma-separated list of slave nameservers (eg: “ns1.some-slave.com,ns2.some-slave.com”). If ns-type is ‘sec’, then ns1 is used to designate the master nameserver. Both ns1 and slave-nameservers should be left blank when using the ‘pri-sec’ service.

ns2 and ns3

(along with ns1, which had dual-use) used to hold the slave nameservers for ‘pri’ service. ns2 and ns3 are now fully deprecated and should no longer be used or even included in any POST OR PUT requests. They will be removed in the next version of the API. For backwards compatibility in this version, when ns-type is ‘pri’, ns1, ns2, and ns3 will contain the first 3 values from slave-nameservers.

nx-ttl

Default “domain/host not found” TTL (time-to-live), in seconds, when a host record for this domain doesn’t exist. If nil, our nameservers will use the lesser of 3 hours or the default-ttl value. (optional; read/write)

restrict-axfr

Indicates if AXFR transfers should be restricted to the list of IPs in axfr-ips. Only valid for master/primary domains. (optional; read/write)

slave-nameservers

The remote slave nameservers, in a comma-separated list. Required when ns-type is ‘pri’. (read/write)

tag-list

List of all tags associated with this domain. Tags are space separated; use quotes for multi-word tags. (optional; read/write)

updated-at

Last update time of this resource. (readonly)

zone-template-id

The ID of the Zone Template to inherit or copy from. See follow_template above. (read/write)