managed_zone_operations
Creates, updates, deletes, gets or lists a managed_zone_operations
resource.
Overview
Name | managed_zone_operations |
Type | Resource |
Id | google.dns.managed_zone_operations |
Fields
The following fields are returned by SELECT
queries:
- get
- list
Successful response
Name | Datatype | Description |
---|---|---|
id | string | Unique identifier for the resource. This is the client_operation_id if the client specified it when the mutation was initiated, otherwise, it is generated by the server. The name must be 1-63 characters long and match the regular expression [-a-z0-9]? (output only) |
dnsKeyContext | object | Only populated if the operation targeted a DnsKey (output only). (id: OperationDnsKeyContext) |
kind | string | (default: dns#operation) |
startTime | string | The time that this operation was started by the server. This is in RFC3339 text format (output only). |
status | string | Status of the operation. Can be one of the following: "PENDING" or "DONE" (output only). A status of "DONE" means that the request to update the authoritative servers has been sent, but the servers might not be updated yet. |
type | string | Type of the operation. Operations include insert, update, and delete (output only). |
user | string | User who requested the operation, for example: user@example.com. cloud-dns-system for operations automatically done by the system. (output only) |
zoneContext | object | Only populated if the operation targeted a ManagedZone (output only). (id: OperationManagedZoneContext) |
Successful response
Name | Datatype | Description |
---|---|---|
id | string | Unique identifier for the resource. This is the client_operation_id if the client specified it when the mutation was initiated, otherwise, it is generated by the server. The name must be 1-63 characters long and match the regular expression [-a-z0-9]? (output only) |
dnsKeyContext | object | Only populated if the operation targeted a DnsKey (output only). (id: OperationDnsKeyContext) |
kind | string | (default: dns#operation) |
startTime | string | The time that this operation was started by the server. This is in RFC3339 text format (output only). |
status | string | Status of the operation. Can be one of the following: "PENDING" or "DONE" (output only). A status of "DONE" means that the request to update the authoritative servers has been sent, but the servers might not be updated yet. |
type | string | Type of the operation. Operations include insert, update, and delete (output only). |
user | string | User who requested the operation, for example: user@example.com. cloud-dns-system for operations automatically done by the system. (output only) |
zoneContext | object | Only populated if the operation targeted a ManagedZone (output only). (id: OperationManagedZoneContext) |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | project , managedZone , operation | clientOperationId | Fetches the representation of an existing Operation. |
list | select | project , managedZone | maxResults , pageToken , sortBy | Enumerates Operations for the given ManagedZone. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
managedZone | string | |
operation | string | |
project | string | |
clientOperationId | string | |
maxResults | integer (int32) | |
pageToken | string | |
sortBy | string |
SELECT
examples
- get
- list
Fetches the representation of an existing Operation.
SELECT
id,
dnsKeyContext,
kind,
startTime,
status,
type,
user,
zoneContext
FROM google.dns.managed_zone_operations
WHERE project = '{{ project }}' -- required
AND managedZone = '{{ managedZone }}' -- required
AND operation = '{{ operation }}' -- required
AND clientOperationId = '{{ clientOperationId }}';
Enumerates Operations for the given ManagedZone.
SELECT
id,
dnsKeyContext,
kind,
startTime,
status,
type,
user,
zoneContext
FROM google.dns.managed_zone_operations
WHERE project = '{{ project }}' -- required
AND managedZone = '{{ managedZone }}' -- required
AND maxResults = '{{ maxResults }}'
AND pageToken = '{{ pageToken }}'
AND sortBy = '{{ sortBy }}';