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/v1, unless otherwise noted
create POST  /projects/project/managedZones/managedZone/changes Atomically updates the ResourceRecordSet collection.
get GET  /projects/project/managedZones/managedZone/changes/changeId Fetches the representation of an existing Change.
list GET  /projects/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, unless otherwise noted
get GET  /projects/project/managedZones/managedZone/dnsKeys/dnsKeyId Fetches the representation of an existing DnsKey.
list GET  /projects/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, unless otherwise noted
get GET  /projects/project/managedZones/managedZone/operations/operation Fetches the representation of an existing Operation.
list GET  /projects/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, unless otherwise noted
create POST  /projects/project/managedZones Creates a new ManagedZone.
delete DELETE  /projects/project/managedZones/managedZone Deletes a previously created ManagedZone.
get GET  /projects/project/managedZones/managedZone Fetches the representation of an existing ManagedZone.
getiampolicy POST  /managedZones/getiampolicy Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
list GET  /projects/project/managedZones Enumerates ManagedZones that have been created but not yet deleted.
patch PATCH  /projects/project/managedZones/managedZone Applies a partial update to an existing ManagedZone.
setiampolicy POST  /managedZones/setiampolicy Sets the access control policy on the specified resource. Replaces any existing policy.

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
testiampermissions POST  /managedZones/testiampermissions Returns permissions that a caller has on the specified resource. If the resource does not exist, this returns an empty set of permissions, not a `NOT_FOUND` error.

Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
update PUT  /projects/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, unless otherwise noted
create POST  /projects/project/policies Creates a new Policy.
delete DELETE  /projects/project/policies/policy Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
get GET  /projects/project/policies/policy Fetches the representation of an existing Policy.
list GET  /projects/project/policies Enumerates all Policies associated with a project.
patch PATCH  /projects/project/policies/policy Applies a partial update to an existing Policy.
update PUT  /projects/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, unless otherwise noted
get GET  /projects/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, unless otherwise noted
create POST  /projects/project/managedZones/managedZone/rrsets Creates a new ResourceRecordSet.
delete DELETE  /projects/project/managedZones/managedZone/rrsets/name/type Deletes a previously created ResourceRecordSet.
get GET  /projects/project/managedZones/managedZone/rrsets/name/type Fetches the representation of an existing ResourceRecordSet.
list GET  /projects/project/managedZones/managedZone/rrsets Enumerates ResourceRecordSets that you have created but not yet deleted.
patch PATCH  /projects/project/managedZones/managedZone/rrsets/name/type Applies 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/v1, unless otherwise noted
create POST  /projects/project/responsePolicies Creates a new Response Policy
delete DELETE  /projects/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  /projects/project/responsePolicies/responsePolicy Fetches the representation of an existing Response Policy.
list GET  /projects/project/responsePolicies Enumerates all Response Policies associated with a project.
patch PATCH  /projects/project/responsePolicies/responsePolicy Applies a partial update to an existing Response Policy.
update PUT  /projects/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/v1, unless otherwise noted
create POST  /projects/project/responsePolicies/responsePolicy/rules Creates a new Response Policy Rule.
delete DELETE  /projects/project/responsePolicies/responsePolicy/rules/responsePolicyRule Deletes a previously created Response Policy Rule.
get GET  /projects/project/responsePolicies/responsePolicy/rules/responsePolicyRule Fetches the representation of an existing Response Policy Rule.
list GET  /projects/project/responsePolicies/responsePolicy/rules Enumerates all Response Policy Rules associated with a project.
patch PATCH  /projects/project/responsePolicies/responsePolicy/rules/responsePolicyRule Applies a partial update to an existing Response Policy Rule.
update PUT  /projects/project/responsePolicies/responsePolicy/rules/responsePolicyRule Updates an existing Response Policy Rule.