Add Start of Authority Record - BlueCat Address Manager - 8.3.2

Address Manager API Guide

prodname
BlueCat Address Manager
version_custom
8.3.2

Adds SOA records.

Output / Response

Returns the object ID for the new SOA record.

API call:

long addStartOfAuthority ( long parentId, String email, long refresh, long retry, long expire, long minimum, String properties )
Parameter Description
parentId The object ID of the parent object of the SOA record.
email Specifies the email address of the administrator for the zones to which the SOA applies.
refresh The amount of time that a slave server waits before attempting to refresh zone files from the master server. This is specified in seconds using a 32-bit integer value. RFC 1912 recommends a value between 1200 and 4300 seconds.
retry Specifies the amount of time that the slave server should wait before re-attempting a zone transfer from the master server after the refresh value has expired. This is specified as a number of seconds using a 32-bit integer value.
expire Specifies the length of time that a slave server will use a non-updated set of zone data before it stops sending queries. This is specified as a number of seconds using a 32-bit integer. RFC 1912 recommends a value from 1209600 to 2419200 seconds or 2 to 4 weeks.
minimum Specifies the maximum amount of time that a negative cache response is held in cache. A negative cache response is a response to a DNS query that does not return an IP address (a failed request). Until this value expires, queries for this DNS record return an error. The maximum value for this field is 10800 seconds, or 3 hours.
properties Adds object properties, including comments and user-defined fields. The supported properties are time-to-live (TTL), primary server (mname) and serial number format (serialNumberFormat). To override the default TTL value for SOA records, use ObjectProperties.ttl=”<value>” in the properties string.