docs: update comments

PiperOrigin-RevId: 602784576
googleapis · Jan 30, 2024 · ce93f79 · ce93f79
1 parent 00b0ded
commit ce93f79
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 7 deletions.
diff --git a/google/cloud/kms/v1/cloudkms_v1.yaml b/google/cloud/kms/v1/cloudkms_v1.yaml
@@ -8,6 +8,7 @@ apis:
 - name: google.cloud.kms.v1.KeyManagementService
 - name: google.cloud.location.Locations
 - name: google.iam.v1.IAMPolicy
+- name: google.longrunning.Operations
 
 types:
 - name: google.cloud.kms.v1.LocationMetadata

diff --git a/google/cloud/kms/v1/resources.proto b/google/cloud/kms/v1/resources.proto
@@ -642,7 +642,7 @@ message CryptoKeyVersion {
   bool reimport_eligible = 18 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
-// The public key for a given
+// The public keys for a given
 // [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Obtained via
 // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
 message PublicKey {
@@ -651,10 +651,12 @@ message PublicKey {
     pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}/publicKey"
   };
 
-  // The public key, encoded in PEM format. For more information, see the
-  // [RFC 7468](https://tools.ietf.org/html/rfc7468) sections for
-  // [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and
-  // [Textual Encoding of Subject Public Key Info]
+  // A public key encoded in PEM format, populated only when
+  // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]
+  // returns one key. For more information, see the [RFC
+  // 7468](https://tools.ietf.org/html/rfc7468) sections for [General
+  // Considerations](https://tools.ietf.org/html/rfc7468#section-2) and [Textual
+  // Encoding of Subject Public Key Info]
   // (https://tools.ietf.org/html/rfc7468#section-13).
   string pem = 1;
 
@@ -663,8 +665,10 @@ message PublicKey {
   // associated with this key.
   CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 2;
 
-  // Integrity verification field. A CRC32C checksum of the returned
-  // [PublicKey.pem][google.cloud.kms.v1.PublicKey.pem]. An integrity check of
+  // Integrity verification field: A CRC32C checksum of the returned
+  // [PublicKey.pem][google.cloud.kms.v1.PublicKey.pem]. It is only populated
+  // when [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]
+  // returns one key. An integrity check of
   // [PublicKey.pem][google.cloud.kms.v1.PublicKey.pem] can be performed by
   // computing the CRC32C checksum of
   // [PublicKey.pem][google.cloud.kms.v1.PublicKey.pem] and comparing your