feat: Adding eTag field to AutokeyConfig

Google APIs · copybara-github · commit 29b2bad19a6a · 2025-05-14T20:27:21.000-07:00
docs: Updating docs for total_size field in KMS List APIs

PiperOrigin-RevId: 758946748
diff --git a/google/cloud/kms/v1/autokey_admin.proto b/google/cloud/kms/v1/autokey_admin.proto
@@ -147,6 +147,12 @@ message AutokeyConfig {
 
   // Output only. The state for the AutokeyConfig.
   State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. A checksum computed by the server based on the value of other
+  // fields. This may be sent on update requests to ensure that the client has
+  // an up-to-date value before proceeding. The request will be rejected with an
+  // ABORTED error on a mismatched etag.
+  string etag = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for
diff --git a/google/cloud/kms/v1/ekm_service.proto b/google/cloud/kms/v1/ekm_service.proto
@@ -168,6 +168,10 @@ message ListEkmConnectionsResponse {
 
   // The total number of [EkmConnections][google.cloud.kms.v1.EkmConnection]
   // that matched the query.
+  //
+  // This field is not populated if
+  // [ListEkmConnectionsRequest.filter][google.cloud.kms.v1.ListEkmConnectionsRequest.filter]
+  // is applied.
   int32 total_size = 3;
 }
 
diff --git a/google/cloud/kms/v1/resources.proto b/google/cloud/kms/v1/resources.proto
@@ -349,6 +349,7 @@ message CryptoKeyVersion {
   // The suffix following `HMAC_` corresponds to the hash algorithm being used
   // (eg. SHA256).
   //
+  // Algorithms beginning with `PQ_` are post-quantum.
   //
   // For more information, see [Key purposes and algorithms]
   // (https://cloud.google.com/kms/docs/algorithms).
@@ -499,7 +500,7 @@ message CryptoKeyVersion {
     // state.
     DISABLED = 2;
 
-    // This version is destroyed, and the key material is no longer stored.
+    // This key material of this version is destroyed and no longer stored.
     // This version may only become
     // [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED]
     // again if this version is
diff --git a/google/cloud/kms/v1/service.proto b/google/cloud/kms/v1/service.proto
@@ -576,6 +576,10 @@ message ListKeyRingsResponse {
 
   // The total number of [KeyRings][google.cloud.kms.v1.KeyRing] that matched
   // the query.
+  //
+  // This field is not populated if
+  // [ListKeyRingsRequest.filter][google.cloud.kms.v1.ListKeyRingsRequest.filter]
+  // is applied.
   int32 total_size = 3;
 }
 
@@ -592,6 +596,10 @@ message ListCryptoKeysResponse {
 
   // The total number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] that
   // matched the query.
+  //
+  // This field is not populated if
+  // [ListCryptoKeysRequest.filter][google.cloud.kms.v1.ListCryptoKeysRequest.filter]
+  // is applied.
   int32 total_size = 3;
 }
 
@@ -609,6 +617,10 @@ message ListCryptoKeyVersionsResponse {
   // The total number of
   // [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] that matched the
   // query.
+  //
+  // This field is not populated if
+  // [ListCryptoKeyVersionsRequest.filter][google.cloud.kms.v1.ListCryptoKeyVersionsRequest.filter]
+  // is applied.
   int32 total_size = 3;
 }
 
@@ -625,6 +637,10 @@ message ListImportJobsResponse {
 
   // The total number of [ImportJobs][google.cloud.kms.v1.ImportJob] that
   // matched the query.
+  //
+  // This field is not populated if
+  // [ListImportJobsRequest.filter][google.cloud.kms.v1.ListImportJobsRequest.filter]
+  // is applied.
   int32 total_size = 3;
 }
 

Original file line number	Diff line number	Diff line change
`@@ -168,6 +168,10 @@ message ListEkmConnectionsResponse {`
`168`	`168`
`169`	`169`	`// The total number of [EkmConnections][google.cloud.kms.v1.EkmConnection]`
`170`	`170`	`// that matched the query.`
	`171`	`+ //`
	`172`	`+ // This field is not populated if`
	`173`	`+ // [ListEkmConnectionsRequest.filter][google.cloud.kms.v1.ListEkmConnectionsRequest.filter]`
	`174`	`+ // is applied.`
`171`	`175`	`int32 total_size = 3;`
`172`	`176`	`}`
`173`	`177`