docs: A comment for field revision_id in message .google.cloud.workflows.v1beta.Workflow is changed

Google APIs · copybara-github · commit febcd2b4b32a · 2025-04-03T09:06:29.000-07:00
docs: A comment for field `service_account` in message `.google.cloud.workflows.v1beta.Workflow` is changed
docs: A comment for field `source_contents` in message `.google.cloud.workflows.v1beta.Workflow` is changed

PiperOrigin-RevId: 743585163
diff --git a/google/cloud/workflows/v1beta/workflows.proto b/google/cloud/workflows/v1beta/workflows.proto
@@ -21,6 +21,7 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -34,7 +35,8 @@ option java_package = "com.google.cloud.workflows.v1beta";
 // networking interruptions.
 service Workflows {
   option (google.api.default_host) = "workflows.googleapis.com";
-  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
 
   // Lists Workflows in a given project and location.
   // The default order is not specified.
@@ -56,7 +58,8 @@ service Workflows {
   // Creates a new workflow. If a workflow with the specified name already
   // exists in the specified project and location, the long running operation
   // will return [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS] error.
-  rpc CreateWorkflow(CreateWorkflowRequest) returns (google.longrunning.Operation) {
+  rpc CreateWorkflow(CreateWorkflowRequest)
+      returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*/locations/*}/workflows"
       body: "workflow"
@@ -71,7 +74,8 @@ service Workflows {
   // Deletes a workflow with the specified name.
   // This method also cancels and deletes all running executions of the
   // workflow.
-  rpc DeleteWorkflow(DeleteWorkflowRequest) returns (google.longrunning.Operation) {
+  rpc DeleteWorkflow(DeleteWorkflowRequest)
+      returns (google.longrunning.Operation) {
     option (google.api.http) = {
       delete: "/v1beta/{name=projects/*/locations/*/workflows/*}"
     };
@@ -87,7 +91,8 @@ service Workflows {
   // workflow. A new revision of the workflow may be created as a result of a
   // successful update operation. In that case, such revision will be used
   // in new workflow executions.
-  rpc UpdateWorkflow(UpdateWorkflowRequest) returns (google.longrunning.Operation) {
+  rpc UpdateWorkflow(UpdateWorkflowRequest)
+      returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v1beta/{workflow.name=projects/*/locations/*/workflows/*}"
       body: "workflow"
@@ -130,23 +135,29 @@ message Workflow {
 
   // Output only. The revision of the workflow.
   // A new revision of a workflow is created as a result of updating the
-  // following fields of a workflow:
-  // - `source_code`
-  // - `service_account`
+  // following properties of a workflow:
+  //
+  // - [Service account][google.cloud.workflows.v1beta.Workflow.service_account]
+  // - [Workflow code to be
+  // executed][google.cloud.workflows.v1beta.Workflow.source_contents]
+  //
   // The format is "000001-a4d", where the first 6 characters define
   // the zero-padded revision ordinal number. They are followed by a hyphen and
   // 3 hexadecimal random characters.
   string revision_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The timestamp of when the workflow was created.
-  google.protobuf.Timestamp create_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+  google.protobuf.Timestamp create_time = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The last update timestamp of the workflow.
-  google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+  google.protobuf.Timestamp update_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The timestamp that the latest revision of the workflow
   // was created.
-  google.protobuf.Timestamp revision_create_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+  google.protobuf.Timestamp revision_create_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Labels associated with this workflow.
   // Labels can contain at most 64 entries. Keys and values can be no longer
@@ -155,14 +166,14 @@ message Workflow {
   // International characters are allowed.
   map<string, string> labels = 8;
 
-  // Name of the service account associated with the latest workflow version.
+  // The service account associated with the latest workflow version.
   // This service account represents the identity of the workflow and determines
   // what permissions the workflow has.
-  // Format: projects/{project}/serviceAccounts/{account}
+  // Format: projects/{project}/serviceAccounts/{account} or {account}
   //
-  // Using `-` as a wildcard for the `{project}` will infer the project from
-  // the account. The `{account}` value can be the `email` address or the
-  // `unique_id` of the service account.
+  // Using `-` as a wildcard for the `{project}` or not providing one at all
+  // will infer the project from the account. The `{account}` value can be the
+  // `email` address or the `unique_id` of the service account.
   //
   // If not provided, workflow will use the project's default service account.
   // Modifying this field for an existing workflow results in a new workflow
@@ -173,7 +184,7 @@ message Workflow {
   // Modifying this field for an existing workflow results in a new workflow
   // revision.
   oneof source_code {
-    // Workflow code to be executed. The size limit is 32KB.
+    // Workflow code to be executed. The size limit is 128KB.
     string source_contents = 10;
   }
 }
diff --git a/google/cloud/workflows/v1beta/workflows_v1beta.yaml b/google/cloud/workflows/v1beta/workflows_v1beta.yaml
@@ -4,7 +4,9 @@ name: workflows.googleapis.com
 title: Workflows API
 
 apis:
+- name: google.cloud.location.Locations
 - name: google.cloud.workflows.v1beta.Workflows
+- name: google.longrunning.Operations
 
 types:
 - name: google.cloud.workflows.v1beta.OperationMetadata
@@ -20,19 +22,6 @@ documentation:
   - selector: google.cloud.location.Locations.ListLocations
     description: Lists information about the supported locations for this service.
 
-backend:
-  rules:
-  - selector: google.cloud.location.Locations.GetLocation
-    deadline: 60.0
-  - selector: google.cloud.location.Locations.ListLocations
-    deadline: 60.0
-  - selector: 'google.cloud.workflows.v1beta.Workflows.*'
-    deadline: 60.0
-  - selector: 'google.longrunning.Operations.*'
-    deadline: 60.0
-  - selector: google.longrunning.Operations.GetOperation
-    deadline: 5.0
-
 http:
   rules:
   - selector: google.cloud.location.Locations.GetLocation
