From febcd2b4b32aaec298bd2872cffeeddaa22383d7 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Thu, 3 Apr 2025 09:05:41 -0700 Subject: [PATCH] docs: A comment for field `revision_id` in message `.google.cloud.workflows.v1beta.Workflow` is changed 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 --- google/cloud/workflows/v1beta/workflows.proto | 43 ++++++++++++------- .../workflows/v1beta/workflows_v1beta.yaml | 15 +------ 2 files changed, 29 insertions(+), 29 deletions(-) diff --git a/google/cloud/workflows/v1beta/workflows.proto b/google/cloud/workflows/v1beta/workflows.proto index e16eddd93c..67d5c97f3d 100644 --- 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 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 index 039c92e293..de64168586 100644 --- 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