feat(cloudkms): update the api

yoshi-automation · yoshi-automation · commit 7dc278459cbd · 2021-08-10T07:07:29.000Z
#### cloudkms:v1

The following keys were added:
- resources.projects.resources.locations.methods.generateRandomBytes (Total Keys: 12)
- schemas.CryptoKey.properties.destroyScheduledDuration (Total Keys: 2)
- schemas.CryptoKey.properties.importOnly.type (Total Keys: 1)
- schemas.GenerateRandomBytesRequest (Total Keys: 5)
- schemas.GenerateRandomBytesResponse (Total Keys: 6)
diff --git a/docs/dyn/cloudkms_v1.projects.locations.html b/docs/dyn/cloudkms_v1.projects.locations.html
@@ -82,6 +82,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
+  <code><a href="#generateRandomBytes">generateRandomBytes(location, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Generate random bytes using the Cloud KMS randomness source in the provided location.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets information about a location.</p>
@@ -97,6 +100,34 @@ <h3>Method Details</h3>
   <pre>Close httplib2 connections.</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="generateRandomBytes">generateRandomBytes(location, body=None, x__xgafv=None)</code>
+  <pre>Generate random bytes using the Cloud KMS randomness source in the provided location.
+
+Args:
+  location: string, The project-specific location in which to generate random bytes. For example, &quot;projects/my-project/locations/us-central1&quot;. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for KeyManagementService.GenerateRandomBytes.
+  &quot;lengthBytes&quot;: 42, # The length in bytes of the amount of randomness to retrieve. Minimum 8 bytes, maximum 1024 bytes.
+  &quot;protectionLevel&quot;: &quot;A String&quot;, # The ProtectionLevel to use when generating the random data. Defaults to SOFTWARE.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for KeyManagementService.GenerateRandomBytes.
+  &quot;data&quot;: &quot;A String&quot;, # The generated data.
+  &quot;dataCrc32c&quot;: &quot;A String&quot;, # Integrity verification field. A CRC32C checksum of the returned GenerateRandomBytesResponse.data. An integrity check of GenerateRandomBytesResponse.data can be performed by computing the CRC32C checksum of GenerateRandomBytesResponse.data and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
   <pre>Gets information about a location.
diff --git a/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html b/docs/dyn/cloudkms_v1.projects.locations.keyRings.cryptoKeys.html
@@ -132,6 +132,8 @@ <h3>Method Details</h3>
 
 { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
@@ -188,6 +190,8 @@ <h3>Method Details</h3>
 
     { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
@@ -315,6 +319,8 @@ <h3>Method Details</h3>
 
     { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
@@ -434,6 +440,8 @@ <h3>Method Details</h3>
   &quot;cryptoKeys&quot;: [ # The list of CryptoKeys.
     { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
       &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+      &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+      &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
       &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
         &quot;a_key&quot;: &quot;A String&quot;,
       },
@@ -508,6 +516,8 @@ <h3>Method Details</h3>
 
 { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
@@ -563,6 +573,8 @@ <h3>Method Details</h3>
 
     { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
@@ -746,6 +758,8 @@ <h3>Method Details</h3>
 
     { # A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which this CryptoKey was created.
+  &quot;destroyScheduledDuration&quot;: &quot;A String&quot;, # Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.
+  &quot;importOnly&quot;: True or False, # Immutable. Whether this key may contain imported versions only.
   &quot;labels&quot;: { # Labels with user-defined metadata. For more information, see [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
diff --git a/googleapiclient/discovery_cache/documents/cloudkms.v1.json b/googleapiclient/discovery_cache/documents/cloudkms.v1.json
@@ -112,6 +112,35 @@
       "resources": {
         "locations": {
           "methods": {
+            "generateRandomBytes": {
+              "description": "Generate random bytes using the Cloud KMS randomness source in the provided location.",
+              "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:generateRandomBytes",
+              "httpMethod": "POST",
+              "id": "cloudkms.projects.locations.generateRandomBytes",
+              "parameterOrder": [
+                "location"
+              ],
+              "parameters": {
+                "location": {
+                  "description": "The project-specific location in which to generate random bytes. For example, \"projects/my-project/locations/us-central1\".",
+                  "location": "path",
+                  "pattern": "^projects/[^/]+/locations/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1/{+location}:generateRandomBytes",
+              "request": {
+                "$ref": "GenerateRandomBytesRequest"
+              },
+              "response": {
+                "$ref": "GenerateRandomBytesResponse"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/cloud-platform",
+                "https://www.googleapis.com/auth/cloudkms"
+              ]
+            },
             "get": {
               "description": "Gets information about a location.",
               "flatPath": "v1/projects/{projectsId}/locations/{locationsId}",
@@ -1317,7 +1346,7 @@
       }
     }
   },
-  "revision": "20210723",
+  "revision": "20210803",
   "rootUrl": "https://cloudkms.googleapis.com/",
   "schemas": {
     "AsymmetricDecryptRequest": {
@@ -1539,6 +1568,15 @@
           "readOnly": true,
           "type": "string"
         },
+        "destroyScheduledDuration": {
+          "description": "Immutable. The period of time that versions of this key spend in the DESTROY_SCHEDULED state before transitioning to DESTROYED. If not specified at creation time, the default duration is 24 hours.",
+          "format": "google-duration",
+          "type": "string"
+        },
+        "importOnly": {
+          "description": "Immutable. Whether this key may contain imported versions only.",
+          "type": "boolean"
+        },
         "labels": {
           "additionalProperties": {
             "type": "string"
@@ -2007,6 +2045,51 @@
       },
       "type": "object"
     },
+    "GenerateRandomBytesRequest": {
+      "description": "Request message for KeyManagementService.GenerateRandomBytes.",
+      "id": "GenerateRandomBytesRequest",
+      "properties": {
+        "lengthBytes": {
+          "description": "The length in bytes of the amount of randomness to retrieve. Minimum 8 bytes, maximum 1024 bytes.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "protectionLevel": {
+          "description": "The ProtectionLevel to use when generating the random data. Defaults to SOFTWARE.",
+          "enum": [
+            "PROTECTION_LEVEL_UNSPECIFIED",
+            "SOFTWARE",
+            "HSM",
+            "EXTERNAL"
+          ],
+          "enumDescriptions": [
+            "Not specified.",
+            "Crypto operations are performed in software.",
+            "Crypto operations are performed in a Hardware Security Module.",
+            "Crypto operations are performed by an external key manager."
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "GenerateRandomBytesResponse": {
+      "description": "Response message for KeyManagementService.GenerateRandomBytes.",
+      "id": "GenerateRandomBytesResponse",
+      "properties": {
+        "data": {
+          "description": "The generated data.",
+          "format": "byte",
+          "type": "string"
+        },
+        "dataCrc32c": {
+          "description": "Integrity verification field. A CRC32C checksum of the returned GenerateRandomBytesResponse.data. An integrity check of GenerateRandomBytesResponse.data can be performed by computing the CRC32C checksum of GenerateRandomBytesResponse.data and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.",
+          "format": "int64",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "ImportCryptoKeyVersionRequest": {
       "description": "Request message for KeyManagementService.ImportCryptoKeyVersion.",
       "id": "ImportCryptoKeyVersionRequest",
