This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.
Resource types
- Changes
- DnsKeys
- ManagedZoneOperations
- ManagedZones
- Policies
- Projects
- ResourceRecordSets
- ResponsePolicies
- ResponsePolicyRules
Changes
For Changes Resource details, see the resource representation page.
| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://dns.googleapis.com/dns/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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/v1beta2, 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. |