feat: [run] Adds gRPC probe support to Cloud Run v2 API client librar…

…ies (#8729) * feat: Adds gRPC probe support to Cloud Run v2 API client libraries PiperOrigin-RevId: 486175948 Source-Link: googleapis/googleapis@153e959 Source-Link: https://github.com/googleapis/googleapis-gen/commit/bb74acdc8d3012dea0b94858363198542226fc01 Copy-Tag: eyJwIjoiamF2YS1ydW4vLk93bEJvdC55YW1sIiwiaCI6ImJiNzRhY2RjOGQzMDEyZGVhMGI5NDg1ODM2MzE5ODU0MjIyNmZjMDEifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Nov 8, 2022 · 0f2a881 · 0f2a881
1 parent 3c65834
commit 0f2a881
Show file tree

Hide file tree

Showing 55 changed files with 1,902 additions and 621 deletions.
diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java
@@ -217,7 +217,8 @@ public final OperationsClient getHttpJsonOperationsClient() {
    * }</pre>
    *
    * @param name Required. The full name of the Execution. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
+   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
+   *     can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Execution getExecution(ExecutionName name) {
@@ -245,7 +246,8 @@ public final Execution getExecution(ExecutionName name) {
    * }</pre>
    *
    * @param name Required. The full name of the Execution. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
+   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
+   *     can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Execution getExecution(String name) {
@@ -332,7 +334,8 @@ public final UnaryCallable<GetExecutionRequest, Execution> getExecutionCallable(
    *
    * @param parent 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}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListExecutionsPagedResponse listExecutions(JobName parent) {
@@ -365,7 +368,8 @@ public final ListExecutionsPagedResponse listExecutions(JobName parent) {
    *
    * @param parent 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}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListExecutionsPagedResponse listExecutions(String parent) {
@@ -499,7 +503,8 @@ public final ListExecutionsPagedResponse listExecutions(ListExecutionsRequest re
    * }</pre>
    *
    * @param name Required. The name of the Execution to delete. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
+   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
+   *     can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Execution, Execution> deleteExecutionAsync(ExecutionName name) {
@@ -527,7 +532,8 @@ public final OperationFuture<Execution, Execution> deleteExecutionAsync(Executio
    * }</pre>
    *
    * @param name Required. The name of the Execution to delete. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
+   *     projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
+   *     can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Execution, Execution> deleteExecutionAsync(String name) {

diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java
@@ -223,7 +223,7 @@ public final OperationsClient getHttpJsonOperationsClient() {
    * }</pre>
    *
    * @param parent Required. The location and project in which this Job should be created. Format:
-   *     projects/{project}/locations/{location}
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @param job Required. The Job instance to create.
    * @param jobId Required. The unique identifier for the Job. The name of the job becomes
    *     {parent}/jobs/{job_id}.
@@ -261,7 +261,7 @@ public final OperationFuture<Job, Job> createJobAsync(
    * }</pre>
    *
    * @param parent Required. The location and project in which this Job should be created. Format:
-   *     projects/{project}/locations/{location}
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @param job Required. The Job instance to create.
    * @param jobId Required. The unique identifier for the Job. The name of the job becomes
    *     {parent}/jobs/{job_id}.
@@ -384,7 +384,8 @@ public final UnaryCallable<CreateJobRequest, Operation> createJobCallable() {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Job getJob(JobName name) {
@@ -412,7 +413,8 @@ public final Job getJob(JobName name) {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Job getJob(String name) {
@@ -496,7 +498,7 @@ public final UnaryCallable<GetJobRequest, Job> getJobCallable() {
    * }</pre>
    *
    * @param parent Required. The location and project to list resources on. Format:
-   *     projects/{project}/locations/{location}
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListJobsPagedResponse listJobs(LocationName parent) {
@@ -526,7 +528,7 @@ public final ListJobsPagedResponse listJobs(LocationName parent) {
    * }</pre>
    *
    * @param parent Required. The location and project to list resources on. Format:
-   *     projects/{project}/locations/{location}
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListJobsPagedResponse listJobs(String parent) {
@@ -772,7 +774,8 @@ public final UnaryCallable<UpdateJobRequest, Operation> updateJobCallable() {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Job, Job> deleteJobAsync(JobName name) {
@@ -800,7 +803,8 @@ public final OperationFuture<Job, Job> deleteJobAsync(JobName name) {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Job, Job> deleteJobAsync(String name) {
@@ -916,7 +920,8 @@ public final UnaryCallable<DeleteJobRequest, Operation> deleteJobCallable() {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Execution, Execution> runJobAsync(JobName name) {
@@ -944,7 +949,8 @@ public final OperationFuture<Execution, Execution> runJobAsync(JobName name) {
    * }</pre>
    *
    * @param name Required. The full name of the Job. Format:
-   *     projects/{project}/locations/{location}/jobs/{job}
+   *     projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
+   *     number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Execution, Execution> runJobAsync(String name) {
@@ -1043,7 +1049,7 @@ public final UnaryCallable<RunJobRequest, Operation> runJobCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Get the IAM Access Control policy currently in effect for the given Job. This result does not
+   * Gets the IAM Access Control policy currently in effect for the given Job. This result does not
    * include any inherited policies.
    *
    * <p>Sample code:
@@ -1073,7 +1079,7 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Get the IAM Access Control policy currently in effect for the given Job. This result does not
+   * Gets the IAM Access Control policy currently in effect for the given Job. This result does not
    * include any inherited policies.
    *
    * <p>Sample code:

diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java
@@ -224,11 +224,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
    * }</pre>
    *
    * @param parent Required. The location and project in which this service should be created.
-   *     Format: projects/{project}/locations/{location} Only lowercase characters, digits, and
-   *     hyphens.
+   *     Format: projects/{project}/locations/{location}, where {project} can be project id or
+   *     number. Only lowercase characters, digits, and hyphens.
    * @param service Required. The Service instance to create.
    * @param serviceId Required. The unique identifier for the Service. It must begin with letter,
-   *     and may not end with hyphen; must contain fewer than 50 characters. The name of the service
+   *     and cannot end with hyphen; must contain fewer than 50 characters. The name of the service
    *     becomes {parent}/services/{service_id}.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -264,11 +264,11 @@ public final OperationFuture<Service, Service> createServiceAsync(
    * }</pre>
    *
    * @param parent Required. The location and project in which this service should be created.
-   *     Format: projects/{project}/locations/{location} Only lowercase characters, digits, and
-   *     hyphens.
+   *     Format: projects/{project}/locations/{location}, where {project} can be project id or
+   *     number. Only lowercase characters, digits, and hyphens.
    * @param service Required. The Service instance to create.
    * @param serviceId Required. The unique identifier for the Service. It must begin with letter,
-   *     and may not end with hyphen; must contain fewer than 50 characters. The name of the service
+   *     and cannot end with hyphen; must contain fewer than 50 characters. The name of the service
    *     becomes {parent}/services/{service_id}.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -395,7 +395,8 @@ public final UnaryCallable<CreateServiceRequest, Operation> createServiceCallabl
    * }</pre>
    *
    * @param name Required. The full name of the Service. Format:
-   *     projects/{project}/locations/{location}/services/{service}
+   *     projects/{project}/locations/{location}/services/{service}, where {project} can be project
+   *     id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Service getService(ServiceName name) {
@@ -423,7 +424,8 @@ public final Service getService(ServiceName name) {
    * }</pre>
    *
    * @param name Required. The full name of the Service. Format:
-   *     projects/{project}/locations/{location}/services/{service}
+   *     projects/{project}/locations/{location}/services/{service}, where {project} can be project
+   *     id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Service getService(String name) {
@@ -507,8 +509,8 @@ public final UnaryCallable<GetServiceRequest, Service> getServiceCallable() {
    * }</pre>
    *
    * @param parent Required. The location and project to list resources on. Location must be a valid
-   *     GCP region, and may not be the "-" wildcard. Format:
-   *     projects/{project}/locations/{location}
+   *     GCP region, and cannot be the "-" wildcard. Format:
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListServicesPagedResponse listServices(LocationName parent) {
@@ -540,8 +542,8 @@ public final ListServicesPagedResponse listServices(LocationName parent) {
    * }</pre>
    *
    * @param parent Required. The location and project to list resources on. Location must be a valid
-   *     GCP region, and may not be the "-" wildcard. Format:
-   *     projects/{project}/locations/{location}
+   *     GCP region, and cannot be the "-" wildcard. Format:
+   *     projects/{project}/locations/{location}, where {project} can be project id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListServicesPagedResponse listServices(String parent) {
@@ -790,7 +792,8 @@ public final UnaryCallable<UpdateServiceRequest, Operation> updateServiceCallabl
    * }</pre>
    *
    * @param name Required. The full name of the Service. Format:
-   *     projects/{project}/locations/{location}/services/{service}
+   *     projects/{project}/locations/{location}/services/{service}, where {project} can be project
+   *     id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Service, Service> deleteServiceAsync(ServiceName name) {
@@ -819,7 +822,8 @@ public final OperationFuture<Service, Service> deleteServiceAsync(ServiceName na
    * }</pre>
    *
    * @param name Required. The full name of the Service. Format:
-   *     projects/{project}/locations/{location}/services/{service}
+   *     projects/{project}/locations/{location}/services/{service}, where {project} can be project
+   *     id or number.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Service, Service> deleteServiceAsync(String name) {

diff --git a/java-run/grpc-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/JobsGrpc.java b/java-run/grpc-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/JobsGrpc.java
@@ -523,7 +523,7 @@ public void runJob(
      *
      *
      * <pre>
-     * Get the IAM Access Control policy currently in effect for the given Job.
+     * Gets the IAM Access Control policy currently in effect for the given Job.
      * This result does not include any inherited policies.
      * </pre>
      */
@@ -732,7 +732,7 @@ public void runJob(
      *
      *
      * <pre>
-     * Get the IAM Access Control policy currently in effect for the given Job.
+     * Gets the IAM Access Control policy currently in effect for the given Job.
      * This result does not include any inherited policies.
      * </pre>
      */
@@ -879,7 +879,7 @@ public com.google.longrunning.Operation runJob(com.google.cloud.run.v2.RunJobReq
      *
      *
      * <pre>
-     * Get the IAM Access Control policy currently in effect for the given Job.
+     * Gets the IAM Access Control policy currently in effect for the given Job.
      * This result does not include any inherited policies.
      * </pre>
      */
@@ -1016,7 +1016,7 @@ public com.google.common.util.concurrent.ListenableFuture<com.google.cloud.run.v
      *
      *
      * <pre>
-     * Get the IAM Access Control policy currently in effect for the given Job.
+     * Gets the IAM Access Control policy currently in effect for the given Job.
      * This result does not include any inherited policies.
      * </pre>
      */

diff --git a/...run/proto-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequest.java b/...run/proto-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequest.java
@@ -75,7 +75,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * <pre>
    * Required. The location and project in which this Job should be created.
-   * Format: projects/{project}/locations/{location}
+   * Format: projects/{project}/locations/{location}, where {project} can be
+   * project id or number.
    * </pre>
    *
    * <code>
@@ -101,7 +102,8 @@ public java.lang.String getParent() {
    *
    * <pre>
    * Required. The location and project in which this Job should be created.
-   * Format: projects/{project}/locations/{location}
+   * Format: projects/{project}/locations/{location}, where {project} can be
+   * project id or number.
    * </pre>
    *
    * <code>
@@ -650,7 +652,8 @@ public Builder mergeFrom(
      *
      * <pre>
      * Required. The location and project in which this Job should be created.
-     * Format: projects/{project}/locations/{location}
+     * Format: projects/{project}/locations/{location}, where {project} can be
+     * project id or number.
      * </pre>
      *
      * <code>
@@ -675,7 +678,8 @@ public java.lang.String getParent() {
      *
      * <pre>
      * Required. The location and project in which this Job should be created.
-     * Format: projects/{project}/locations/{location}
+     * Format: projects/{project}/locations/{location}, where {project} can be
+     * project id or number.
      * </pre>
      *
      * <code>
@@ -700,7 +704,8 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * <pre>
      * Required. The location and project in which this Job should be created.
-     * Format: projects/{project}/locations/{location}
+     * Format: projects/{project}/locations/{location}, where {project} can be
+     * project id or number.
      * </pre>
      *
      * <code>
@@ -724,7 +729,8 @@ public Builder setParent(java.lang.String value) {
      *
      * <pre>
      * Required. The location and project in which this Job should be created.
-     * Format: projects/{project}/locations/{location}
+     * Format: projects/{project}/locations/{location}, where {project} can be
+     * project id or number.
      * </pre>
      *
      * <code>
@@ -744,7 +750,8 @@ public Builder clearParent() {
      *
      * <pre>
      * Required. The location and project in which this Job should be created.
-     * Format: projects/{project}/locations/{location}
+     * Format: projects/{project}/locations/{location}, where {project} can be
+     * project id or number.
      * </pre>
      *
      * <code>

diff --git a/...-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequestOrBuilder.java b/...-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequestOrBuilder.java
@@ -28,7 +28,8 @@ public interface CreateJobRequestOrBuilder
    *
    * <pre>
    * Required. The location and project in which this Job should be created.
-   * Format: projects/{project}/locations/{location}
+   * Format: projects/{project}/locations/{location}, where {project} can be
+   * project id or number.
    * </pre>
    *
    * <code>
@@ -43,7 +44,8 @@ public interface CreateJobRequestOrBuilder
    *
    * <pre>
    * Required. The location and project in which this Job should be created.
-   * Format: projects/{project}/locations/{location}
+   * Format: projects/{project}/locations/{location}, where {project} can be
+   * project id or number.
    * </pre>
    *
    * <code>