G-g-core
Zones

Get Zone

Changed on

Zone info by zone name.

get/dns/v2/zones/{name}

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/dns/v2/zones/{name}
  • Auth
    HTTP apikey

Path parameters

namestring required

Response

ItemZoneResponse

contactstring

email address of the administrator responsible for this zone

dnssec_enabledboolean

describe dnssec status true means dnssec is enabled for the zone false means dnssec is disabled for the zone

dnssec_statusstring

dnssec_status is the four-state lifecycle status of DNSSEC for the zone, driven by the parent-DS scan against the registrar. One of: pending, active, pending-disabled, disabled. Empty when DNSSEC has never been enabled for the zone.

dnssec_status_modified_onstring

dnssec_status_modified_on is the RFC3339 timestamp of the last dnssec_status change.

enabledboolean
expiryinteger

number of seconds after which secondary name servers should stop answering request for this zone

idinteger

ID of zone. This field usually is omitted in response and available only in case of getting deleted zones by admin.

metaobject

arbitrarily data of zone in json format

namestring

name of DNS zone

nx_ttlinteger

Time To Live of cache

primary_serverstring

primary master name server for zone

refreshinteger

number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.

retryinteger

number of seconds after which secondary name servers should retry to request the serial number

serialinteger

Serial number for this zone or Timestamp of zone modification moment. If a secondary name server slaved to this one observes an increase in this number, the slave will assume that the zone has been updated and initiate a zone transfer.

statusstring

Changes

  • 796429501557Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status