For a list of methods for this resource, see the end of this page.

Resource representations

An operation represents a successful mutation performed on a Cloud DNS resource. Operations provide: - An audit log of server resource mutations. - A way to recover/retry API calls in the case where the response is never received by the caller. Use the caller specified client_operation_id.

  "kind": "dns#operation",
  "id": string,
  "startTime": string,
  "status": string,
  "user": string,
  "type": string,
  "zoneContext": {
    "oldValue": managedZones Resource,
    "newValue": managedZones Resource
  "dnsKeyContext": {
    "oldValue": dnsKeys Resource,
    "newValue": dnsKeys Resource
Property name Value Description Notes
dnsKeyContext nested object Only populated if the operation targeted a DnsKey (output only).
dnsKeyContext.newValue nested object The post-operation DnsKey resource.
dnsKeyContext.oldValue nested object The pre-operation DnsKey resource.
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)
kind string Identifies what kind of resource this is. Value: the fixed string "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.

Acceptable values are:
  • "done"
  • "pending"
type string Type of the operation. Operations include insert, update, and delete (output only).
user string User who requested the operation, for example: cloud-dns-system for operations automatically done by the system. (output only)
zoneContext nested object Only populated if the operation targeted a ManagedZone (output only).
zoneContext.newValue nested object The post-operation ManagedZone resource.
zoneContext.oldValue nested object The pre-operation ManagedZone resource.


Fetches the representation of an existing Operation.
Enumerates Operations for the given ManagedZone.