docs: update generated docs (#981)
diff --git a/docs/dyn/dns_v1.changes.html b/docs/dyn/dns_v1.changes.html
index ed17263..904b0e4 100644
--- a/docs/dyn/dns_v1.changes.html
+++ b/docs/dyn/dns_v1.changes.html
@@ -72,219 +72,311 @@
</style>
-<h1><a href="dns_v1.html">Google Cloud DNS API</a> . <a href="dns_v1.changes.html">changes</a></h1>
+<h1><a href="dns_v1.html">Cloud DNS API</a> . <a href="dns_v1.changes.html">changes</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#create">create(project, managedZone, body=None, clientOperationId=None)</a></code></p>
-<p class="firstline"></p>
+ <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)</a></code></p>
-<p class="firstline"></p>
+ <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, maxResults=None, pageToken=None, sortBy=None, sortOrder=None)</a></code></p>
-<p class="firstline"></p>
+ <code><a href="#list">list(project, managedZone, pageToken=None, maxResults=None, sortBy=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)</code>
- <pre>
+ <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, A parameter (required)
- managedZone: string, A parameter (required)
+ 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:
-{
- "additions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "deletions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "id": "A String",
- "isServing": True or False,
- "kind": "dns#change", # Identifies what kind of resource this is. Value: the fixed string "dns#change".
- "startTime": "A String",
- "status": "A String",
- }
-
- clientOperationId: string, A parameter
-
-Returns:
- An object of the form:
-
- {
- "additions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
+{ # 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.
+ "kind": "dns#change",
+ "startTime": "A String", # The time that this operation was started by the server (output only). This
+ # is in RFC3339 text format.
+ "isServing": True or False, # If the DNS queries for the zone will be served.
+ "additions": [ # Which ResourceRecordSets to add?
+ { # A unit of data that will be returned by the DNS servers.
+ "kind": "dns#resourceRecordSet",
+ "signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).
+ "A String",
],
- "deletions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "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.
+ "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",
],
- "id": "A String",
- "isServing": True or False,
- "kind": "dns#change", # Identifies what kind of resource this is. Value: the fixed string "dns#change".
- "startTime": "A String",
- "status": "A String",
- }</pre>
-</div>
-
-<div class="method">
- <code class="details" id="get">get(project, managedZone, changeId, clientOperationId=None)</code>
- <pre>
-
-Args:
- project: string, A parameter (required)
- managedZone: string, A parameter (required)
- changeId: string, A parameter (required)
- clientOperationId: string, A parameter
-
-Returns:
- An object of the form:
-
- {
- "additions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "deletions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "id": "A String",
- "isServing": True or False,
- "kind": "dns#change", # Identifies what kind of resource this is. Value: the fixed string "dns#change".
- "startTime": "A String",
- "status": "A String",
- }</pre>
-</div>
-
-<div class="method">
- <code class="details" id="list">list(project, managedZone, maxResults=None, pageToken=None, sortBy=None, sortOrder=None)</code>
- <pre>
-
-Args:
- project: string, A parameter (required)
- managedZone: string, A parameter (required)
- maxResults: integer, A parameter
- pageToken: string, A parameter
- sortBy: string, A parameter
- Allowed values
- changeSequence -
- sortOrder: string, A parameter
-
-Returns:
- An object of the form:
-
- {
- "changes": [
- {
- "additions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "deletions": [
- {
- "kind": "dns#resourceRecordSet", # Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet".
- "name": "A String",
- "rrdatas": [
- "A String",
- ],
- "signatureRrdatas": [
- "A String",
- ],
- "ttl": 42,
- "type": "A String",
- },
- ],
- "id": "A String",
- "isServing": True or False,
- "kind": "dns#change", # Identifies what kind of resource this is. Value: the fixed string "dns#change".
- "startTime": "A String",
- "status": "A String",
- },
- ],
- "header": {
- "operationId": "A String",
+ "name": "A String", # For example, www.example.com.
},
+ ],
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "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.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+}
+
+ 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.
+ "kind": "dns#change",
+ "startTime": "A String", # The time that this operation was started by the server (output only). This
+ # is in RFC3339 text format.
+ "isServing": True or False, # If the DNS queries for the zone will be served.
+ "additions": [ # Which ResourceRecordSets to add?
+ { # A unit of data that will be returned by the DNS servers.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "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.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ }</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.
+ "kind": "dns#change",
+ "startTime": "A String", # The time that this operation was started by the server (output only). This
+ # is in RFC3339 text format.
+ "isServing": True or False, # If the DNS queries for the zone will be served.
+ "additions": [ # Which ResourceRecordSets to add?
+ { # A unit of data that will be returned by the DNS servers.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "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.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="list">list(project, managedZone, pageToken=None, maxResults=None, sortBy=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.
+ maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the
+server will decide how many results to return.
+ sortBy: string, Sorting criterion. The only supported value is change sequence.
+ 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.
+ "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.
+ "kind": "dns#change",
+ "startTime": "A String", # The time that this operation was started by the server (output only). This
+ # is in RFC3339 text format.
+ "isServing": True or False, # If the DNS queries for the zone will be served.
+ "additions": [ # Which ResourceRecordSets to add?
+ { # A unit of data that will be returned by the DNS servers.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "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.
+ "kind": "dns#resourceRecordSet",
+ "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.
+ "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",
+ ],
+ "name": "A String", # For example, www.example.com.
+ },
+ ],
+ },
+ ],
"kind": "dns#changesListResponse", # Type of resource.
- "nextPageToken": "A String",
+ "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.
}</pre>
</div>