docs: update generated docs (#981)
diff --git a/docs/dyn/dns_v1beta2.dnsKeys.html b/docs/dyn/dns_v1beta2.dnsKeys.html
index 778c055..6875efa 100644
--- a/docs/dyn/dns_v1beta2.dnsKeys.html
+++ b/docs/dyn/dns_v1beta2.dnsKeys.html
@@ -72,92 +72,155 @@
</style>
-<h1><a href="dns_v1beta2.html">Google Cloud DNS API</a> . <a href="dns_v1beta2.dnsKeys.html">dnsKeys</a></h1>
+<h1><a href="dns_v1beta2.html">Cloud DNS API</a> . <a href="dns_v1beta2.dnsKeys.html">dnsKeys</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#get">get(project, managedZone, dnsKeyId, clientOperationId=None, digestType=None)</a></code></p>
-<p class="firstline"></p>
+ <code><a href="#get">get(project, managedZone, dnsKeyId, digestType=None, clientOperationId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Fetch the representation of an existing DnsKey.</p>
<p class="toc_element">
- <code><a href="#list">list(project, managedZone, digestType=None, maxResults=None, pageToken=None)</a></code></p>
-<p class="firstline"></p>
+ <code><a href="#list">list(project, managedZone, pageToken=None, maxResults=None, digestType=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Enumerate DnsKeys 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="get">get(project, managedZone, dnsKeyId, clientOperationId=None, digestType=None)</code>
- <pre>
+ <code class="details" id="get">get(project, managedZone, dnsKeyId, digestType=None, clientOperationId=None, x__xgafv=None)</code>
+ <pre>Fetch the representation of an existing DnsKey.
Args:
- project: string, A parameter (required)
- managedZone: string, A parameter (required)
- dnsKeyId: string, A parameter (required)
- clientOperationId: string, A parameter
- digestType: string, A parameter
+ 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)
+ dnsKeyId: string, The identifier of the requested DnsKey. (required)
+ digestType: string, An optional comma-separated list of digest types to compute and display
+for key signing keys. If omitted, the recommended digest type will be
+computed and displayed.
+ 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:
- {
- "algorithm": "A String",
- "creationTime": "A String",
- "description": "A String",
- "digests": [
+ { # A DNSSEC key pair.
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "kind": "dns#dnsKey",
+ "algorithm": "A String", # String mnemonic specifying the DNSSEC algorithm of this key. Immutable
+ # after creation time.
+ "publicKey": "A String", # Base64 encoded public half of this key. Output only.
+ "keyLength": 42, # Length of the key in bits. Specified at creation time then immutable.
+ "creationTime": "A String", # The time that this resource was created in the control plane. This is in
+ # RFC3339 text format. Output only.
+ "isActive": True or False, # Active keys will be used to sign subsequent changes to the ManagedZone.
+ # Inactive keys will still be present as DNSKEY Resource Records for the use
+ # of resolvers validating existing signatures.
+ "digests": [ # Cryptographic hashes of the DNSKEY resource record associated with this
+ # DnsKey. These digests are needed to construct a DS record that points at
+ # this DNS key. Output only.
{
- "digest": "A String",
- "type": "A String",
+ "type": "A String", # Specifies the algorithm used to calculate this digest.
+ "digest": "A String", # The base-16 encoded bytes of this digest. Suitable for use in a DS
+ # resource record.
},
],
- "id": "A String",
- "isActive": True or False,
- "keyLength": 42,
- "keyTag": 42,
- "kind": "dns#dnsKey", # Identifies what kind of resource this is. Value: the fixed string "dns#dnsKey".
- "publicKey": "A String",
- "type": "A String",
+ "type": "A String", # One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type KEY_SIGNING have the
+ # Secure Entry Point flag set and, when active, will be used to sign only
+ # resource record sets of type DNSKEY. Otherwise, the Secure Entry Point
+ # flag will be cleared and this key will be used to sign only resource
+ # record sets of other types. Immutable after creation time.
+ "keyTag": 42, # The key tag is a non-cryptographic hash of the a DNSKEY resource record
+ # associated with this DnsKey. The key tag can be used to identify a DNSKEY
+ # more quickly (but it is not a unique identifier). In particular, the key
+ # tag is used in a parent zone's DS record to point at the DNSKEY in this
+ # child ManagedZone. The key tag is a number in the range [0, 65535] and the
+ # algorithm to calculate it is specified in RFC4034 Appendix B. Output only.
+ "description": "A String", # A mutable string of at most 1024 characters associated with this resource
+ # for the user's convenience. Has no effect on the resource's function.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(project, managedZone, digestType=None, maxResults=None, pageToken=None)</code>
- <pre>
+ <code class="details" id="list">list(project, managedZone, pageToken=None, maxResults=None, digestType=None, x__xgafv=None)</code>
+ <pre>Enumerate DnsKeys to a ResourceRecordSet collection.
Args:
- project: string, A parameter (required)
- managedZone: string, A parameter (required)
- digestType: string, A parameter
- maxResults: integer, A parameter
- pageToken: string, A parameter
+ 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.
+ digestType: string, An optional comma-separated list of digest types to compute and display
+for key signing keys. If omitted, the recommended digest type will be
+computed and displayed.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
Returns:
An object of the form:
- {
- "dnsKeys": [
- {
- "algorithm": "A String",
- "creationTime": "A String",
- "description": "A String",
- "digests": [
+ { # The response to a request to enumerate DnsKeys in a ManagedZone.
+ "kind": "dns#dnsKeysListResponse", # Type of resource.
+ "dnsKeys": [ # The requested resources.
+ { # A DNSSEC key pair.
+ "id": "A String", # Unique identifier for the resource; defined by the server (output only).
+ "kind": "dns#dnsKey",
+ "algorithm": "A String", # String mnemonic specifying the DNSSEC algorithm of this key. Immutable
+ # after creation time.
+ "publicKey": "A String", # Base64 encoded public half of this key. Output only.
+ "keyLength": 42, # Length of the key in bits. Specified at creation time then immutable.
+ "creationTime": "A String", # The time that this resource was created in the control plane. This is in
+ # RFC3339 text format. Output only.
+ "isActive": True or False, # Active keys will be used to sign subsequent changes to the ManagedZone.
+ # Inactive keys will still be present as DNSKEY Resource Records for the use
+ # of resolvers validating existing signatures.
+ "digests": [ # Cryptographic hashes of the DNSKEY resource record associated with this
+ # DnsKey. These digests are needed to construct a DS record that points at
+ # this DNS key. Output only.
{
- "digest": "A String",
- "type": "A String",
+ "type": "A String", # Specifies the algorithm used to calculate this digest.
+ "digest": "A String", # The base-16 encoded bytes of this digest. Suitable for use in a DS
+ # resource record.
},
],
- "id": "A String",
- "isActive": True or False,
- "keyLength": 42,
- "keyTag": 42,
- "kind": "dns#dnsKey", # Identifies what kind of resource this is. Value: the fixed string "dns#dnsKey".
- "publicKey": "A String",
- "type": "A String",
+ "type": "A String", # One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type KEY_SIGNING have the
+ # Secure Entry Point flag set and, when active, will be used to sign only
+ # resource record sets of type DNSKEY. Otherwise, the Secure Entry Point
+ # flag will be cleared and this key will be used to sign only resource
+ # record sets of other types. Immutable after creation time.
+ "keyTag": 42, # The key tag is a non-cryptographic hash of the a DNSKEY resource record
+ # associated with this DnsKey. The key tag can be used to identify a DNSKEY
+ # more quickly (but it is not a unique identifier). In particular, the key
+ # tag is used in a parent zone's DS record to point at the DNSKEY in this
+ # child ManagedZone. The key tag is a number in the range [0, 65535] and the
+ # algorithm to calculate it is specified in RFC4034 Appendix B. Output only.
+ "description": "A String", # A mutable string of at most 1024 characters associated with this resource
+ # for the user's convenience. Has no effect on the resource's function.
},
],
- "header": {
- "operationId": "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).
},
- "kind": "dns#dnsKeysListResponse", # Type of resource.
- "nextPageToken": "A String",
+ "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>