Skip to main content
GET
Get

Authorizations

Authorization
string
header
required

The Authorization header expects a Bearer token.

Path Parameters

id
string
required

Zone ID

Query Parameters

resourceVersion
string<int64>

Optional: expected zone version (metadata.resource_version)

  • If specified, the requested version will be returned if possible (if the version has changed, you will get a FAILED_PRECONDITION error)
  • If not specified or set to 0, the latest zone version will be returned

Response

200 - application/json

A successful response.

Each DNS zone starts at a particular domain within the hierarchical DNS namespace tree, e.g., example.com., and is also responsible for its subdomains (e.g., sales.example.com.) unless there are explicit DNS zones defined for them.

DNS zones contain Resource Records (RRs), which are individual information entries about the domain(s), e.g., a domain's IP address. Each Resource Record is represented in this API by the Record API Resource which is managed by the RecordService.

See the graphical explanation of DNS zones and Resource Records on Wikipedia

metadata
object

Common resource metadata.

spec
DNS Zone specification · object
status
DNS zone status · object