feat: added annotations

Google APIs · copybara-github · commit c46c4ec72b13 · 2024-12-11T13:10:38.000-08:00
docs: Service Account is a required field
fix: Changed field behavior for an existing field `service_account` in message `.google.cloud.config.v1.Deployment`
fix: Changed field behavior for an existing field `service_account` in message `.google.cloud.config.v1.Preview`

PiperOrigin-RevId: 705212738
diff --git a/google/cloud/config/v1/config.proto b/google/cloud/config/v1/config.proto
@@ -135,7 +135,7 @@ service Config {
     option (google.api.method_signature) = "name";
   }
 
-  // Lists [Resource][google.cloud.config.v1.Resource]s in a given revision.
+  // Lists [Resources][google.cloud.config.v1.Resource] in a given revision.
   rpc ListResources(ListResourcesRequest) returns (ListResourcesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/deployments/*/revisions/*}/resources"
@@ -463,11 +463,11 @@ message Deployment {
   optional string artifacts_gcs_bucket = 15
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. User-specified Service Account (SA) credentials to be used when
+  // Required. User-specified Service Account (SA) credentials to be used when
   // actuating resources.
   // Format: `projects/{projectID}/serviceAccounts/{serviceAccount}`
   optional string service_account = 16 [
-    (google.api.field_behavior) = OPTIONAL,
+    (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
       type: "iam.googleapis.com/ServiceAccount"
     }
@@ -523,16 +523,17 @@ message Deployment {
 // describes the resources and configs to be deployed.
 message TerraformBlueprint {
   // Location of the source configs.
+  // Required.
   oneof source {
-    // Required. URI of an object in Google Cloud Storage.
+    // URI of an object in Google Cloud Storage.
     // Format: `gs://{bucket}/{object}`
     //
     // URI may also specify an object version for zipped objects.
     // Format: `gs://{bucket}/{object}#{version}`
-    string gcs_source = 1 [(google.api.field_behavior) = REQUIRED];
+    string gcs_source = 1;
 
-    // Required. URI of a public Git repo.
-    GitSource git_source = 2 [(google.api.field_behavior) = REQUIRED];
+    // URI of a public Git repo.
+    GitSource git_source = 2;
   }
 
   // Input variable values for the Terraform blueprint.
@@ -858,9 +859,9 @@ message OperationMetadata {
 
   // Output only. Identifies whether the user has requested cancellation of the
   // operation. Operations that have successfully been cancelled have
-  // [Operation.error][] value with a
-  // [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to
-  // `Code.CANCELLED`.
+  // [google.longrunning.Operation.error][google.longrunning.Operation.error]
+  // value with a [google.rpc.Status.code][google.rpc.Status.code] of `1`,
+  // corresponding to `Code.CANCELLED`.
   bool requested_cancellation = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. API version used to start the operation.
@@ -1264,7 +1265,7 @@ message ListResourcesRequest {
 
 // A response to a 'ListResources' call. Contains a list of Resources.
 message ListResourcesResponse {
-  // List of [Resources][]s.
+  // List of [Resources][google.cloud.config.v1.Resource].
   repeated Resource resources = 1;
 
   // A token to request the next page of resources from the 'ListResources'
@@ -1521,11 +1522,11 @@ message Preview {
   // Optional. Current mode of preview.
   PreviewMode preview_mode = 15 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. User-specified Service Account (SA) credentials to be used when
+  // Required. User-specified Service Account (SA) credentials to be used when
   // previewing resources.
   // Format: `projects/{projectID}/serviceAccounts/{serviceAccount}`
   string service_account = 7 [
-    (google.api.field_behavior) = OPTIONAL,
+    (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
       type: "iam.googleapis.com/ServiceAccount"
     }
@@ -1592,6 +1593,12 @@ message Preview {
   // Example: "=1.3.10".
   optional string tf_version_constraint = 19
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Arbitrary key-value metadata storage e.g. to help client tools
+  // identifiy preview during automation. See
+  // https://google.aip.dev/148#annotations for details on format and size
+  // limitations.
+  map<string, string> annotations = 20 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Ephemeral metadata content describing the state of a preview operation.
@@ -1753,7 +1760,7 @@ message ListPreviewsRequest {
 
 // A response to a `ListPreviews` call. Contains a list of Previews.
 message ListPreviewsResponse {
-  // List of [Previews][]s.
+  // List of [Previews][google.cloud.config.v1.Preview].
   repeated Preview previews = 1;
 
   // Token to be supplied to the next ListPreviews request via `page_token`
diff --git a/google/cloud/config/v1/config_grpc_service_config.json b/google/cloud/config/v1/config_grpc_service_config.json
@@ -0,0 +1,15 @@
+{
+  "methodConfig": [{
+    "name": [
+      { "service": "google.cloud.config.v1.Config"}
+    ],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "10s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE"]
+    }
+  }]
+}
