API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Resource types

  1. Changes
  2. DnsKeys
  3. ManagedZoneOperations
  4. ManagedZones
  5. Policies
  6. Projects
  7. ResourceRecordSets

Changes

For Changes Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
create POST  /project/managedZones/managedZone/changes Atomically updates the ResourceRecordSet collection.
get GET  /project/managedZones/managedZone/changes/changeId Fetches the representation of an existing Change.
list GET  /project/managedZones/managedZone/changes Enumerates Changes to a ResourceRecordSet collection.

DnsKeys

For DnsKeys Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
get GET  /project/managedZones/managedZone/dnsKeys/dnsKeyId Fetches the representation of an existing DnsKey.
list GET  /project/managedZones/managedZone/dnsKeys Enumerates DnsKeys to a ResourceRecordSet collection.

ManagedZoneOperations

For ManagedZoneOperations Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
get GET  /project/managedZones/managedZone/operations/operation Fetches the representation of an existing Operation.
list GET  /project/managedZones/managedZone/operations Enumerates Operations for the given ManagedZone.

ManagedZones

For ManagedZones Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
create POST  /project/managedZones Creates a new ManagedZone.
delete DELETE  /project/managedZones/managedZone Deletes a previously created ManagedZone.
get GET  /project/managedZones/managedZone Fetches the representation of an existing ManagedZone.
list GET  /project/managedZones Enumerates ManagedZones that have been created but not yet deleted.
patch PATCH  /project/managedZones/managedZone Applies a partial update to an existing ManagedZone.
update PUT  /project/managedZones/managedZone Updates an existing ManagedZone.

Policies

For Policies Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
create POST  /project/policies Creates a new Policy.
delete DELETE  /project/policies/policy Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
get GET  /project/policies/policy Fetches the representation of an existing Policy.
list GET  /project/policies Enumerates all Policies associated with a project.
patch PATCH  /project/policies/policy Applies a partial update to an existing Policy.
update PUT  /project/policies/policy Updates an existing Policy.

Projects

For Projects Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
get GET  /project Fetches the representation of an existing Project.

ResourceRecordSets

For ResourceRecordSets Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1/projects, unless otherwise noted
create POST  /project/managedZones/managedZone/rrsets Creates a new ResourceRecordSet.
delete DELETE  /project/managedZones/managedZone/rrsets/name/type Deletes a previously created ResourceRecordSet.
get GET  /project/managedZones/managedZone/rrsets/name/type Fetches the representation of an existing ResourceRecordSet.
list GET  /project/managedZones/managedZone/rrsets Enumerates ResourceRecordSets that you have created but not yet deleted.
patch PATCH  /project/managedZones/managedZone/rrsets/name/type Applies a partial update to an existing ResourceRecordSet.