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
  8. ResponsePolicies
  9. ResponsePolicyRules

Changes

For Changes Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1beta2/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/v1beta2/projects, unless otherwise noted
get GET  /project/managedZones/managedZone/dnsKeys/dnsKeyId Fetch the representation of an existing DnsKey.
list GET  /project/managedZones/managedZone/dnsKeys Enumerate 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/v1beta2/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/v1beta2/projects, unless otherwise noted
create POST  /project/managedZones Create a new ManagedZone.
delete DELETE  /project/managedZones/managedZone Delete a previously created ManagedZone.
get GET  /project/managedZones/managedZone Fetch the representation of an existing ManagedZone.
list GET  /project/managedZones Enumerate ManagedZones that have been created but not yet deleted.
patch PATCH  /project/managedZones/managedZone Apply a partial update to an existing ManagedZone.
update PUT  /project/managedZones/managedZone Update 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/v1beta2/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 Apply a partial update to an existing Policy.
update PUT  /project/policies/policy Update 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/v1beta2/projects, unless otherwise noted
get GET  /project Fetch 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/v1beta2/projects, unless otherwise noted
create POST  /project/managedZones/managedZone/rrsets Create a new ResourceRecordSet.
delete DELETE  /project/managedZones/managedZone/rrsets/name/type Delete a previously created ResourceRecordSet.
get GET  /project/managedZones/managedZone/rrsets/name/type Fetch 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 Apply a partial update to an existing ResourceRecordSet.

ResponsePolicies

For ResponsePolicies Resource details, see the resource representation page.

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

ResponsePolicyRules

For ResponsePolicyRules Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://dns.googleapis.com/dns/v1beta2/projects, unless otherwise noted
create POST  /project/responsePolicies/responsePolicy/rules Creates a new response policy rule.
delete DELETE  /project/responsePolicies/responsePolicy/rules/responsePolicyRule Deletes a previously created response policy rule.
get GET  /project/responsePolicies/responsePolicy/rules/responsePolicyRule Fetches the representation of an existing response policy rule.
list GET  /project/responsePolicies/responsePolicy/rules Enumerates all response policy rules associated with a project.
patch PATCH  /project/responsePolicies/responsePolicy/rules/responsePolicyRule Applies a partial update to an existing response policy rule.
update PUT  /project/responsePolicies/responsePolicy/rules/responsePolicyRule Updates an existing response policy rule.