chore: Enable requesting numeric enums in "transport=rest" responses …

…for services supporting this (Java, Go, Python, PHP, TypeScript, C#, and Ruby), even if they do not yet turn on REST transport (#30) - [ ] Regenerate this pull request now. chore: disallow "transport=rest" for services where numeric enums are not confirmed to be supported (except in PHP and Java) PiperOrigin-RevId: 493113566 Source-Link: https://togithub.com/googleapis/googleapis/commit/758f0d1217d9c7fe398aa5efb1057ce4b6409e55 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/78bd8f05e1276363eb14eae70e91fe4bc20703ab Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNzhiZDhmMDVlMTI3NjM2M2ViMTRlYWU3MGU5MWZlNGJjMjA3MDNhYiJ9 BEGIN_NESTED_COMMIT feat: Adds gRPC probe support to Cloud Run v2 API client libraries PiperOrigin-RevId: 486175948 Source-Link: https://togithub.com/googleapis/googleapis/commit/153e9592bb199fd55d800b0e7482eeb128ed8b25 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/bb74acdc8d3012dea0b94858363198542226fc01 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmI3NGFjZGM4ZDMwMTJkZWEwYjk0ODU4MzYzMTk4NTQyMjI2ZmMwMSJ9 END_NESTED_COMMIT BEGIN_NESTED_COMMIT feat: Adds Cloud Run Jobs v2 API client libraries A Cloud Run Job runs its tasks and exits when finished. For more information about Cloud Run Jobs, visit https://cloud.google.com/run/docs/create-jobs PiperOrigin-RevId: 485653075 Source-Link: https://togithub.com/googleapis/googleapis/commit/a9a137b7420e8569c14c7a1c9cb31c2ee49fd14c Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/7d398ce68ad0101db60130d526950df0efcaddce Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiN2QzOThjZTY4YWQwMTAxZGI2MDEzMGQ1MjY5NTBkZjBlZmNhZGRjZSJ9 END_NESTED_COMMITBEGIN_NESTED_COMMITfeat: Adds Startup and Liveness probes to Cloud Run v2 API client libraries For more information about this feature, visit https://cloud.google.com/run/docs/configuring/healthchecks PiperOrigin-RevId: 481203788 Source-Link: https://togithub.com/googleapis/googleapis/commit/778762cee04435d22f5bf313da0ab59bc5083195 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/1479c7a63fc7d5b5d98c48e9ba1d0b6a94e95513 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTQ3OWM3YTYzZmM3ZDViNWQ5OGM0OGU5YmExZDBiNmE5NGU5NTUxMyJ9 END_NESTED_COMMIT
googleapis · Jan 6, 2023 · 8942de0 · 8942de0
1 parent 9233d6f
commit 8942de0
Show file tree

Hide file tree

Showing 56 changed files with 41,301 additions and 10,147 deletions.
diff --git a/packages/google-cloud-run/protos/google/cloud/run/v2/condition.proto b/packages/google-cloud-run/protos/google/cloud/run/v2/condition.proto
@@ -162,6 +162,9 @@ message Condition {
     // A task reached its retry limit and the last attempt failed due to the
     // user container exiting with a non-zero exit code.
     NON_ZERO_EXIT_CODE = 2;
+
+    // The execution was cancelled by users.
+    CANCELLED = 3;
   }
 
   // type is used to communicate the status of the reconciliation process.
@@ -185,7 +188,7 @@ message Condition {
 
   // The reason for this condition. Depending on the condition type,
   // it will populate one of these fields.
-  // Successful conditions may not have a reason.
+  // Successful conditions cannot have a reason.
   oneof reasons {
     // A common (service-level) reason for this condition.
     CommonReason reason = 6;

diff --git a/packages/google-cloud-run/protos/google/cloud/run/v2/execution.proto b/packages/google-cloud-run/protos/google/cloud/run/v2/execution.proto
@@ -0,0 +1,256 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.run.v2;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/launch_stage.proto";
+import "google/api/resource.proto";
+import "google/cloud/run/v2/condition.proto";
+import "google/cloud/run/v2/task_template.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/run/v2;run";
+option java_multiple_files = true;
+option java_outer_classname = "ExecutionProto";
+option java_package = "com.google.cloud.run.v2";
+
+// Cloud Run Execution Control Plane API.
+service Executions {
+  option (google.api.default_host) = "run.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Gets information about an Execution.
+  rpc GetExecution(GetExecutionRequest) returns (Execution) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/locations/*/jobs/*/executions/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists Executions from a Job.
+  rpc ListExecutions(ListExecutionsRequest) returns (ListExecutionsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/locations/*/jobs/*}/executions"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Deletes an Execution.
+  rpc DeleteExecution(DeleteExecutionRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/locations/*/jobs/*/executions/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "Execution"
+      metadata_type: "Execution"
+    };
+  }
+}
+
+// Request message for obtaining a Execution by its full name.
+message GetExecutionRequest {
+  // Required. The full name of the Execution.
+  // Format:
+  // projects/{project}/locations/{location}/jobs/{job}/executions/{execution},
+  // where {project} can be project id or number.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "run.googleapis.com/Execution"
+    }
+  ];
+}
+
+// Request message for retrieving a list of Executions.
+message ListExecutionsRequest {
+  // Required. The Execution from which the Executions should be listed.
+  // To list all Executions across Jobs, use "-" instead of Job name.
+  // Format: projects/{project}/locations/{location}/jobs/{job}, where {project}
+  // can be project id or number.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "run.googleapis.com/Execution"
+    }
+  ];
+
+  // Maximum number of Executions to return in this call.
+  int32 page_size = 2;
+
+  // A page token received from a previous call to ListExecutions.
+  // All other parameters must match.
+  string page_token = 3;
+
+  // If true, returns deleted (but unexpired) resources along with active ones.
+  bool show_deleted = 4;
+}
+
+// Response message containing a list of Executions.
+message ListExecutionsResponse {
+  // The resulting list of Executions.
+  repeated Execution executions = 1;
+
+  // A token indicating there are more items than page_size. Use it in the next
+  // ListExecutions request to continue.
+  string next_page_token = 2;
+}
+
+// Request message for deleting an Execution.
+message DeleteExecutionRequest {
+  // Required. The name of the Execution to delete.
+  // Format:
+  // projects/{project}/locations/{location}/jobs/{job}/executions/{execution},
+  // where {project} can be project id or number.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "run.googleapis.com/Execution"
+    }
+  ];
+
+  // Indicates that the request should be validated without actually
+  // deleting any resources.
+  bool validate_only = 2;
+
+  // A system-generated fingerprint for this version of the resource.
+  // This may be used to detect modification conflict during updates.
+  string etag = 3;
+}
+
+// Execution represents the configuration of a single execution. A execution an
+// immutable resource that references a container image which is run to
+// completion.
+message Execution {
+  option (google.api.resource) = {
+    type: "run.googleapis.com/Execution"
+    pattern: "projects/{project}/locations/{location}/jobs/{job}/executions/{execution}"
+    style: DECLARATIVE_FRIENDLY
+  };
+
+  // Output only. The unique name of this Execution.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Server assigned unique identifier for the Execution. The value is a UUID4
+  // string and guaranteed to remain unchanged until the resource is deleted.
+  string uid = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A number that monotonically increases every time the user
+  // modifies the desired state.
+  int64 generation = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // KRM-style labels for the resource.
+  // User-provided labels are shared with Google's billing system, so they can
+  // be used to filter, or break down billing charges by team, component,
+  // environment, state, etc. For more information, visit
+  // https://cloud.google.com/resource-manager/docs/creating-managing-labels or
+  // https://cloud.google.com/run/docs/configuring/labels
+  // Cloud Run will populate some labels with 'run.googleapis.com' or
+  // 'serving.knative.dev' namespaces. Those labels are read-only, and user
+  // changes will not be preserved.
+  map<string, string> labels = 4;
+
+  // KRM-style annotations for the resource.
+  map<string, string> annotations = 5;
+
+  // Output only. Represents time when the execution was acknowledged by the execution
+  // controller. It is not guaranteed to be set in happens-before order across
+  // separate operations.
+  google.protobuf.Timestamp create_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Represents time when the execution started to run.
+  // It is not guaranteed to be set in happens-before order across separate
+  // operations.
+  google.protobuf.Timestamp start_time = 22 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Represents time when the execution was completed. It is not guaranteed to
+  // be set in happens-before order across separate operations.
+  google.protobuf.Timestamp completion_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. For a deleted resource, the deletion time. It is only
+  // populated as a response to a Delete request.
+  google.protobuf.Timestamp delete_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. For a deleted resource, the time after which it will be
+  // permamently deleted. It is only populated as a response to a Delete
+  // request.
+  google.protobuf.Timestamp expire_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Set the launch stage to a preview stage on write to allow use of preview
+  // features in that stage. On read, describes whether the resource uses
+  // preview features. Launch Stages are defined at [Google Cloud Platform
+  // Launch Stages](https://cloud.google.com/terms/launch-stages).
+  google.api.LaunchStage launch_stage = 11;
+
+  // Output only. The name of the parent Job.
+  string job = 12 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "run.googleapis.com/Job"
+    }
+  ];
+
+  // Output only. Specifies the maximum desired number of tasks the execution should
+  // run at any given time. Must be <= task_count. The actual number of
+  // tasks running in steady state will be less than this number when
+  // ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when
+  // the work left to do is less than max parallelism. More info:
+  // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+  int32 parallelism = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Specifies the desired number of tasks the execution should run.
+  // Setting to 1 means that parallelism is limited to 1 and the success of
+  // that task signals the success of the execution.
+  // More info:
+  // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+  int32 task_count = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The template used to create tasks for this execution.
+  TaskTemplate template = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Indicates whether the resource's reconciliation is still in progress.
+  // See comments in `Job.reconciling` for additional information on
+  // reconciliation process in Cloud Run.
+  bool reconciling = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The Condition of this Execution, containing its readiness status, and
+  // detailed error information in case it did not reach the desired state.
+  repeated Condition conditions = 17 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The generation of this Execution. See comments in `reconciling` for
+  // additional information on reconciliation process in Cloud Run.
+  int64 observed_generation = 18 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The number of actively running tasks.
+  int32 running_count = 19 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The number of tasks which reached phase Succeeded.
+  int32 succeeded_count = 20 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The number of tasks which reached phase Failed.
+  int32 failed_count = 21 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A system-generated fingerprint for this version of the
+  // resource. May be used to detect modification conflict during updates.
+  string etag = 99 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/packages/google-cloud-run/protos/google/cloud/run/v2/execution_template.proto b/packages/google-cloud-run/protos/google/cloud/run/v2/execution_template.proto
@@ -0,0 +1,54 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.run.v2;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/run/v2/task_template.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/run/v2;run";
+option java_multiple_files = true;
+option java_outer_classname = "ExecutionTemplateProto";
+option java_package = "com.google.cloud.run.v2";
+
+// ExecutionTemplate describes the data an execution should have when created
+// from a template.
+message ExecutionTemplate {
+  // KRM-style labels for the resource.
+  map<string, string> labels = 1;
+
+  // KRM-style annotations for the resource.
+  map<string, string> annotations = 2;
+
+  // Specifies the maximum desired number of tasks the execution should run at
+  // given time. Must be <= task_count.
+  // When the job is run, if this field is 0 or unset, the maximum possible
+  // value will be used for that execution.
+  // The actual number of tasks running in steady state will be less than this
+  // number when there are fewer tasks waiting to be completed remaining,
+  // i.e. when the work left to do is less than max parallelism.
+  int32 parallelism = 3;
+
+  // Specifies the desired number of tasks the execution should run.
+  // Setting to 1 means that parallelism is limited to 1 and the success of
+  // that task signals the success of the execution.
+  // More info:
+  // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+  int32 task_count = 4;
+
+  // Required. Describes the task(s) that will be created when executing an execution.
+  TaskTemplate template = 5 [(google.api.field_behavior) = REQUIRED];
+}