getdnssoarecResult Structure Definition

The getdnssoarecResult structure defines the return type for getdnssoarec API.

Syntax



Members

rc

If the method succeeds, rc is 0 else rc > 0. Values above 0x8000 indicate Warnings.

message

If the method succeeds, message is NULL else message contains Error/Warning message.

dnssoarecList

List of dnssoarecs


dnssoarec Structure Definition

The dnssoarec structure defines the actual return type values for getdnssoarec API.

Syntax



Members

domain

The domain name.

type

Type of records to display.

originserver

Domain name of the name server that responds authoritatively for the domain.

contact

Email address of the contact to whom domain issues can be addressed. In the email address, replace the @ sign with a period (.). For example, enter domainadmin.example.com instead of domainadmin@example.com.

serial

The secondary server uses this parameter to determine whether it requires a zone transfer from the primary server.

refresh

Time, in seconds, for which a secondary server must wait between successive checks on the value of the serial number.

retry

Time, in seconds, between retries if a secondary server's attempt to contact the primary server for a zone refresh fails.

expire

Time, in seconds, after which the zone data on a secondary name server can no longer be considered authoritative because all refresh and retry attempts made during the period have failed. After the expiry period, the secondary server stops serving the zone. Typically one week. Not used by the primary server.

minimum

Default time to live (TTL) for all records in the zone. Can be overridden for individual records.

ttl

Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone's minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600.

authtype

Record type.

_nextgenapiresource


See Also