public
dns

Read one zone

Lifecycle, publication and delegation observations. Poll this after a mutation until applied_version reaches desired_version.

get/v1/dns-zones/{zoneID}

Request

  • Base URL: https://api.vozora.io
  • URL: https://api.vozora.io/v1/dns-zones/{zoneID}
  • Auth: API key in header Authorization

Path parameters

zoneIDstring required

zone id

Response

OK

alias_healthstring
applied_versioninteger
created_atstring
delegationstring
delegation_observed_atstring
desired_versioninteger

DesiredVersion is what the next If-Match must carry; AppliedVersion is what the estate has actually served. They differ while a change is in flight, which is what a poller watches.

idstring
lifecyclestring
namestring
preparation_expires_atstring

Named for what it is, not for the token: this is when an unverified preparation lapses, and calling it a "token deadline" both puzzles a customer and makes a timestamp look like a credential.

publicationstring
recoverable_untilstring
status_urlstring
suspendedboolean
updated_atstring
verified_atstring

Changes

No recorded changes to this operation across all 1 revision of this API.