| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="dns_v2beta1.html">Cloud DNS API</a> . <a href="dns_v2beta1.changes.html">changes</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#create">create(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Atomically update the ResourceRecordSet collection.</p> |
| <p class="toc_element"> |
| <code><a href="#get">get(project, managedZone, changeId, clientOperationId=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Fetch the representation of an existing Change.</p> |
| <p class="toc_element"> |
| <code><a href="#list">list(project, managedZone, pageToken=None, sortBy=None, maxResults=None, sortOrder=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Enumerate Changes to a ResourceRecordSet collection.</p> |
| <p class="toc_element"> |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| <p class="firstline">Retrieves the next page of results.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="create">create(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)</code> |
| <pre>Atomically update the ResourceRecordSet collection. |
| |
| Args: |
| project: string, Identifies the project addressed by this request. (required) |
| managedZone: string, Identifies the managed zone addressed by this request. Can be the managed |
| zone name or id. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # A Change represents a set of ResourceRecordSet additions and deletions |
| # applied atomically to a ManagedZone. ResourceRecordSets within a |
| # ManagedZone are modified by creating a new Change element in the Changes |
| # collection. In turn the Changes collection also records the past |
| # modifications to the ResourceRecordSets in a ManagedZone. The current |
| # state of the ManagedZone is the sum effect of applying all Change |
| # elements in the Changes collection in sequence. |
| "id": "A String", # Unique identifier for the resource; defined by the server (output only). |
| "additions": [ # Which ResourceRecordSets to add? |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "status": "A String", # Status of the operation (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. |
| "deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly. |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "isServing": True or False, # If the DNS queries for the zone will be served. |
| "kind": "dns#change", |
| "startTime": "A String", # The time that this operation was started by the server (output only). This |
| # is in RFC3339 text format. |
| } |
| |
| clientOperationId: string, For mutating operation requests only. An optional identifier |
| specified by the client. Must be unique for operation resources in the |
| Operations collection. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # A Change represents a set of ResourceRecordSet additions and deletions |
| # applied atomically to a ManagedZone. ResourceRecordSets within a |
| # ManagedZone are modified by creating a new Change element in the Changes |
| # collection. In turn the Changes collection also records the past |
| # modifications to the ResourceRecordSets in a ManagedZone. The current |
| # state of the ManagedZone is the sum effect of applying all Change |
| # elements in the Changes collection in sequence. |
| "id": "A String", # Unique identifier for the resource; defined by the server (output only). |
| "additions": [ # Which ResourceRecordSets to add? |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "status": "A String", # Status of the operation (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. |
| "deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly. |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "isServing": True or False, # If the DNS queries for the zone will be served. |
| "kind": "dns#change", |
| "startTime": "A String", # The time that this operation was started by the server (output only). This |
| # is in RFC3339 text format. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="get">get(project, managedZone, changeId, clientOperationId=None, x__xgafv=None)</code> |
| <pre>Fetch the representation of an existing Change. |
| |
| Args: |
| project: string, Identifies the project addressed by this request. (required) |
| managedZone: string, Identifies the managed zone addressed by this request. Can be the managed |
| zone name or id. (required) |
| changeId: string, The identifier of the requested change, from a previous |
| ResourceRecordSetsChangeResponse. (required) |
| clientOperationId: string, For mutating operation requests only. An optional identifier |
| specified by the client. Must be unique for operation resources in the |
| Operations collection. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # A Change represents a set of ResourceRecordSet additions and deletions |
| # applied atomically to a ManagedZone. ResourceRecordSets within a |
| # ManagedZone are modified by creating a new Change element in the Changes |
| # collection. In turn the Changes collection also records the past |
| # modifications to the ResourceRecordSets in a ManagedZone. The current |
| # state of the ManagedZone is the sum effect of applying all Change |
| # elements in the Changes collection in sequence. |
| "id": "A String", # Unique identifier for the resource; defined by the server (output only). |
| "additions": [ # Which ResourceRecordSets to add? |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "status": "A String", # Status of the operation (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. |
| "deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly. |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "isServing": True or False, # If the DNS queries for the zone will be served. |
| "kind": "dns#change", |
| "startTime": "A String", # The time that this operation was started by the server (output only). This |
| # is in RFC3339 text format. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list">list(project, managedZone, pageToken=None, sortBy=None, maxResults=None, sortOrder=None, x__xgafv=None)</code> |
| <pre>Enumerate Changes to a ResourceRecordSet collection. |
| |
| Args: |
| project: string, Identifies the project addressed by this request. (required) |
| managedZone: string, Identifies the managed zone addressed by this request. Can be the managed |
| zone name or id. (required) |
| pageToken: string, Optional. A tag returned by a previous list request that was truncated. |
| Use this parameter to continue a previous list request. |
| sortBy: string, Sorting criterion. The only supported value is change sequence. |
| maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the |
| server will decide how many results to return. |
| sortOrder: string, Sorting order direction: 'ascending' or 'descending'. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # The response to a request to enumerate Changes to a ResourceRecordSets |
| # collection. |
| "header": { # Elements common to every response. |
| "operationId": "A String", # For mutating operation requests that completed successfully. |
| # This is the client_operation_id if the client specified it, |
| # otherwise it is generated by the server (output only). |
| }, |
| "nextPageToken": "A String", # The presence of this field indicates that there exist more results |
| # following your last page of results in pagination order. To fetch them, |
| # make another list request using this value as your pagination token. |
| # |
| # In this way you can retrieve the complete contents of even very large |
| # collections one page at a time. However, if the contents of the collection |
| # change between the first and last paginated list request, the set of all |
| # elements returned will be an inconsistent view of the collection. There is |
| # no way to retrieve a "snapshot" of collections larger than the maximum |
| # page size. |
| "kind": "dns#changesListResponse", # Type of resource. |
| "changes": [ # The requested changes. |
| { # A Change represents a set of ResourceRecordSet additions and deletions |
| # applied atomically to a ManagedZone. ResourceRecordSets within a |
| # ManagedZone are modified by creating a new Change element in the Changes |
| # collection. In turn the Changes collection also records the past |
| # modifications to the ResourceRecordSets in a ManagedZone. The current |
| # state of the ManagedZone is the sum effect of applying all Change |
| # elements in the Changes collection in sequence. |
| "id": "A String", # Unique identifier for the resource; defined by the server (output only). |
| "additions": [ # Which ResourceRecordSets to add? |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "status": "A String", # Status of the operation (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. |
| "deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly. |
| { # A unit of data that will be returned by the DNS servers. |
| "name": "A String", # For example, www.example.com. |
| "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2). |
| "A String", |
| ], |
| "type": "A String", # The identifier of a supported record type. See the list of |
| # <a href="/dns/docs/overview#supported_dns_record_types">Supported |
| # DNS record types</a>. |
| "ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers. |
| "kind": "dns#resourceRecordSet", |
| "rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see |
| # <a href="/dns/records/json-record">examples</a>. |
| "A String", |
| ], |
| }, |
| ], |
| "isServing": True or False, # If the DNS queries for the zone will be served. |
| "kind": "dns#change", |
| "startTime": "A String", # The time that this operation was started by the server (output only). This |
| # is in RFC3339 text format. |
| }, |
| ], |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| <pre>Retrieves the next page of results. |
| |
| Args: |
| previous_request: The request for the previous page. (required) |
| previous_response: The response from the request for the previous page. (required) |
| |
| Returns: |
| A request object that you can call 'execute()' on to request the next |
| page. Returns None if there are no more items in the collection. |
| </pre> |
| </div> |
| |
| </body></html> |