Skip to content

Commit 0f2a881

Browse files
feat: [run] Adds gRPC probe support to Cloud Run v2 API client libraries (#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>
1 parent 3c65834 commit 0f2a881

File tree

55 files changed

+1902
-621
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+1902
-621
lines changed

java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,8 @@ public final OperationsClient getHttpJsonOperationsClient() {
217217
* }</pre>
218218
*
219219
* @param name Required. The full name of the Execution. Format:
220-
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
220+
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
221+
* can be project id or number.
221222
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
222223
*/
223224
public final Execution getExecution(ExecutionName name) {
@@ -245,7 +246,8 @@ public final Execution getExecution(ExecutionName name) {
245246
* }</pre>
246247
*
247248
* @param name Required. The full name of the Execution. Format:
248-
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
249+
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
250+
* can be project id or number.
249251
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
250252
*/
251253
public final Execution getExecution(String name) {
@@ -332,7 +334,8 @@ public final UnaryCallable<GetExecutionRequest, Execution> getExecutionCallable(
332334
*
333335
* @param parent Required. The Execution from which the Executions should be listed. To list all
334336
* Executions across Jobs, use "-" instead of Job name. Format:
335-
* projects/{project}/locations/{location}/jobs/{job}
337+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
338+
* number.
336339
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
337340
*/
338341
public final ListExecutionsPagedResponse listExecutions(JobName parent) {
@@ -365,7 +368,8 @@ public final ListExecutionsPagedResponse listExecutions(JobName parent) {
365368
*
366369
* @param parent Required. The Execution from which the Executions should be listed. To list all
367370
* Executions across Jobs, use "-" instead of Job name. Format:
368-
* projects/{project}/locations/{location}/jobs/{job}
371+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
372+
* number.
369373
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
370374
*/
371375
public final ListExecutionsPagedResponse listExecutions(String parent) {
@@ -499,7 +503,8 @@ public final ListExecutionsPagedResponse listExecutions(ListExecutionsRequest re
499503
* }</pre>
500504
*
501505
* @param name Required. The name of the Execution to delete. Format:
502-
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
506+
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
507+
* can be project id or number.
503508
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
504509
*/
505510
public final OperationFuture<Execution, Execution> deleteExecutionAsync(ExecutionName name) {
@@ -527,7 +532,8 @@ public final OperationFuture<Execution, Execution> deleteExecutionAsync(Executio
527532
* }</pre>
528533
*
529534
* @param name Required. The name of the Execution to delete. Format:
530-
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}
535+
* projects/{project}/locations/{location}/jobs/{job}/executions/{execution}, where {project}
536+
* can be project id or number.
531537
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
532538
*/
533539
public final OperationFuture<Execution, Execution> deleteExecutionAsync(String name) {

java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@ public final OperationsClient getHttpJsonOperationsClient() {
223223
* }</pre>
224224
*
225225
* @param parent Required. The location and project in which this Job should be created. Format:
226-
* projects/{project}/locations/{location}
226+
* projects/{project}/locations/{location}, where {project} can be project id or number.
227227
* @param job Required. The Job instance to create.
228228
* @param jobId Required. The unique identifier for the Job. The name of the job becomes
229229
* {parent}/jobs/{job_id}.
@@ -261,7 +261,7 @@ public final OperationFuture<Job, Job> createJobAsync(
261261
* }</pre>
262262
*
263263
* @param parent Required. The location and project in which this Job should be created. Format:
264-
* projects/{project}/locations/{location}
264+
* projects/{project}/locations/{location}, where {project} can be project id or number.
265265
* @param job Required. The Job instance to create.
266266
* @param jobId Required. The unique identifier for the Job. The name of the job becomes
267267
* {parent}/jobs/{job_id}.
@@ -384,7 +384,8 @@ public final UnaryCallable<CreateJobRequest, Operation> createJobCallable() {
384384
* }</pre>
385385
*
386386
* @param name Required. The full name of the Job. Format:
387-
* projects/{project}/locations/{location}/jobs/{job}
387+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
388+
* number.
388389
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
389390
*/
390391
public final Job getJob(JobName name) {
@@ -412,7 +413,8 @@ public final Job getJob(JobName name) {
412413
* }</pre>
413414
*
414415
* @param name Required. The full name of the Job. Format:
415-
* projects/{project}/locations/{location}/jobs/{job}
416+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
417+
* number.
416418
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
417419
*/
418420
public final Job getJob(String name) {
@@ -496,7 +498,7 @@ public final UnaryCallable<GetJobRequest, Job> getJobCallable() {
496498
* }</pre>
497499
*
498500
* @param parent Required. The location and project to list resources on. Format:
499-
* projects/{project}/locations/{location}
501+
* projects/{project}/locations/{location}, where {project} can be project id or number.
500502
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
501503
*/
502504
public final ListJobsPagedResponse listJobs(LocationName parent) {
@@ -526,7 +528,7 @@ public final ListJobsPagedResponse listJobs(LocationName parent) {
526528
* }</pre>
527529
*
528530
* @param parent Required. The location and project to list resources on. Format:
529-
* projects/{project}/locations/{location}
531+
* projects/{project}/locations/{location}, where {project} can be project id or number.
530532
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
531533
*/
532534
public final ListJobsPagedResponse listJobs(String parent) {
@@ -772,7 +774,8 @@ public final UnaryCallable<UpdateJobRequest, Operation> updateJobCallable() {
772774
* }</pre>
773775
*
774776
* @param name Required. The full name of the Job. Format:
775-
* projects/{project}/locations/{location}/jobs/{job}
777+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
778+
* number.
776779
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
777780
*/
778781
public final OperationFuture<Job, Job> deleteJobAsync(JobName name) {
@@ -800,7 +803,8 @@ public final OperationFuture<Job, Job> deleteJobAsync(JobName name) {
800803
* }</pre>
801804
*
802805
* @param name Required. The full name of the Job. Format:
803-
* projects/{project}/locations/{location}/jobs/{job}
806+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
807+
* number.
804808
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
805809
*/
806810
public final OperationFuture<Job, Job> deleteJobAsync(String name) {
@@ -916,7 +920,8 @@ public final UnaryCallable<DeleteJobRequest, Operation> deleteJobCallable() {
916920
* }</pre>
917921
*
918922
* @param name Required. The full name of the Job. Format:
919-
* projects/{project}/locations/{location}/jobs/{job}
923+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
924+
* number.
920925
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
921926
*/
922927
public final OperationFuture<Execution, Execution> runJobAsync(JobName name) {
@@ -944,7 +949,8 @@ public final OperationFuture<Execution, Execution> runJobAsync(JobName name) {
944949
* }</pre>
945950
*
946951
* @param name Required. The full name of the Job. Format:
947-
* projects/{project}/locations/{location}/jobs/{job}
952+
* projects/{project}/locations/{location}/jobs/{job}, where {project} can be project id or
953+
* number.
948954
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
949955
*/
950956
public final OperationFuture<Execution, Execution> runJobAsync(String name) {
@@ -1043,7 +1049,7 @@ public final UnaryCallable<RunJobRequest, Operation> runJobCallable() {
10431049

10441050
// AUTO-GENERATED DOCUMENTATION AND METHOD.
10451051
/**
1046-
* Get the IAM Access Control policy currently in effect for the given Job. This result does not
1052+
* Gets the IAM Access Control policy currently in effect for the given Job. This result does not
10471053
* include any inherited policies.
10481054
*
10491055
* <p>Sample code:
@@ -1073,7 +1079,7 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
10731079

10741080
// AUTO-GENERATED DOCUMENTATION AND METHOD.
10751081
/**
1076-
* Get the IAM Access Control policy currently in effect for the given Job. This result does not
1082+
* Gets the IAM Access Control policy currently in effect for the given Job. This result does not
10771083
* include any inherited policies.
10781084
*
10791085
* <p>Sample code:

java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -224,11 +224,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
224224
* }</pre>
225225
*
226226
* @param parent Required. The location and project in which this service should be created.
227-
* Format: projects/{project}/locations/{location} Only lowercase characters, digits, and
228-
* hyphens.
227+
* Format: projects/{project}/locations/{location}, where {project} can be project id or
228+
* number. Only lowercase characters, digits, and hyphens.
229229
* @param service Required. The Service instance to create.
230230
* @param serviceId Required. The unique identifier for the Service. It must begin with letter,
231-
* and may not end with hyphen; must contain fewer than 50 characters. The name of the service
231+
* and cannot end with hyphen; must contain fewer than 50 characters. The name of the service
232232
* becomes {parent}/services/{service_id}.
233233
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
234234
*/
@@ -264,11 +264,11 @@ public final OperationFuture<Service, Service> createServiceAsync(
264264
* }</pre>
265265
*
266266
* @param parent Required. The location and project in which this service should be created.
267-
* Format: projects/{project}/locations/{location} Only lowercase characters, digits, and
268-
* hyphens.
267+
* Format: projects/{project}/locations/{location}, where {project} can be project id or
268+
* number. Only lowercase characters, digits, and hyphens.
269269
* @param service Required. The Service instance to create.
270270
* @param serviceId Required. The unique identifier for the Service. It must begin with letter,
271-
* and may not end with hyphen; must contain fewer than 50 characters. The name of the service
271+
* and cannot end with hyphen; must contain fewer than 50 characters. The name of the service
272272
* becomes {parent}/services/{service_id}.
273273
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
274274
*/
@@ -395,7 +395,8 @@ public final UnaryCallable<CreateServiceRequest, Operation> createServiceCallabl
395395
* }</pre>
396396
*
397397
* @param name Required. The full name of the Service. Format:
398-
* projects/{project}/locations/{location}/services/{service}
398+
* projects/{project}/locations/{location}/services/{service}, where {project} can be project
399+
* id or number.
399400
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
400401
*/
401402
public final Service getService(ServiceName name) {
@@ -423,7 +424,8 @@ public final Service getService(ServiceName name) {
423424
* }</pre>
424425
*
425426
* @param name Required. The full name of the Service. Format:
426-
* projects/{project}/locations/{location}/services/{service}
427+
* projects/{project}/locations/{location}/services/{service}, where {project} can be project
428+
* id or number.
427429
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
428430
*/
429431
public final Service getService(String name) {
@@ -507,8 +509,8 @@ public final UnaryCallable<GetServiceRequest, Service> getServiceCallable() {
507509
* }</pre>
508510
*
509511
* @param parent Required. The location and project to list resources on. Location must be a valid
510-
* GCP region, and may not be the "-" wildcard. Format:
511-
* projects/{project}/locations/{location}
512+
* GCP region, and cannot be the "-" wildcard. Format:
513+
* projects/{project}/locations/{location}, where {project} can be project id or number.
512514
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
513515
*/
514516
public final ListServicesPagedResponse listServices(LocationName parent) {
@@ -540,8 +542,8 @@ public final ListServicesPagedResponse listServices(LocationName parent) {
540542
* }</pre>
541543
*
542544
* @param parent Required. The location and project to list resources on. Location must be a valid
543-
* GCP region, and may not be the "-" wildcard. Format:
544-
* projects/{project}/locations/{location}
545+
* GCP region, and cannot be the "-" wildcard. Format:
546+
* projects/{project}/locations/{location}, where {project} can be project id or number.
545547
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
546548
*/
547549
public final ListServicesPagedResponse listServices(String parent) {
@@ -790,7 +792,8 @@ public final UnaryCallable<UpdateServiceRequest, Operation> updateServiceCallabl
790792
* }</pre>
791793
*
792794
* @param name Required. The full name of the Service. Format:
793-
* projects/{project}/locations/{location}/services/{service}
795+
* projects/{project}/locations/{location}/services/{service}, where {project} can be project
796+
* id or number.
794797
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
795798
*/
796799
public final OperationFuture<Service, Service> deleteServiceAsync(ServiceName name) {
@@ -819,7 +822,8 @@ public final OperationFuture<Service, Service> deleteServiceAsync(ServiceName na
819822
* }</pre>
820823
*
821824
* @param name Required. The full name of the Service. Format:
822-
* projects/{project}/locations/{location}/services/{service}
825+
* projects/{project}/locations/{location}/services/{service}, where {project} can be project
826+
* id or number.
823827
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
824828
*/
825829
public final OperationFuture<Service, Service> deleteServiceAsync(String name) {

java-run/grpc-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/JobsGrpc.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -523,7 +523,7 @@ public void runJob(
523523
*
524524
*
525525
* <pre>
526-
* Get the IAM Access Control policy currently in effect for the given Job.
526+
* Gets the IAM Access Control policy currently in effect for the given Job.
527527
* This result does not include any inherited policies.
528528
* </pre>
529529
*/
@@ -732,7 +732,7 @@ public void runJob(
732732
*
733733
*
734734
* <pre>
735-
* Get the IAM Access Control policy currently in effect for the given Job.
735+
* Gets the IAM Access Control policy currently in effect for the given Job.
736736
* This result does not include any inherited policies.
737737
* </pre>
738738
*/
@@ -879,7 +879,7 @@ public com.google.longrunning.Operation runJob(com.google.cloud.run.v2.RunJobReq
879879
*
880880
*
881881
* <pre>
882-
* Get the IAM Access Control policy currently in effect for the given Job.
882+
* Gets the IAM Access Control policy currently in effect for the given Job.
883883
* This result does not include any inherited policies.
884884
* </pre>
885885
*/
@@ -1016,7 +1016,7 @@ public com.google.common.util.concurrent.ListenableFuture<com.google.cloud.run.v
10161016
*
10171017
*
10181018
* <pre>
1019-
* Get the IAM Access Control policy currently in effect for the given Job.
1019+
* Gets the IAM Access Control policy currently in effect for the given Job.
10201020
* This result does not include any inherited policies.
10211021
* </pre>
10221022
*/

java-run/proto-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequest.java

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
7575
*
7676
* <pre>
7777
* Required. The location and project in which this Job should be created.
78-
* Format: projects/{project}/locations/{location}
78+
* Format: projects/{project}/locations/{location}, where {project} can be
79+
* project id or number.
7980
* </pre>
8081
*
8182
* <code>
@@ -101,7 +102,8 @@ public java.lang.String getParent() {
101102
*
102103
* <pre>
103104
* Required. The location and project in which this Job should be created.
104-
* Format: projects/{project}/locations/{location}
105+
* Format: projects/{project}/locations/{location}, where {project} can be
106+
* project id or number.
105107
* </pre>
106108
*
107109
* <code>
@@ -650,7 +652,8 @@ public Builder mergeFrom(
650652
*
651653
* <pre>
652654
* Required. The location and project in which this Job should be created.
653-
* Format: projects/{project}/locations/{location}
655+
* Format: projects/{project}/locations/{location}, where {project} can be
656+
* project id or number.
654657
* </pre>
655658
*
656659
* <code>
@@ -675,7 +678,8 @@ public java.lang.String getParent() {
675678
*
676679
* <pre>
677680
* Required. The location and project in which this Job should be created.
678-
* Format: projects/{project}/locations/{location}
681+
* Format: projects/{project}/locations/{location}, where {project} can be
682+
* project id or number.
679683
* </pre>
680684
*
681685
* <code>
@@ -700,7 +704,8 @@ public com.google.protobuf.ByteString getParentBytes() {
700704
*
701705
* <pre>
702706
* Required. The location and project in which this Job should be created.
703-
* Format: projects/{project}/locations/{location}
707+
* Format: projects/{project}/locations/{location}, where {project} can be
708+
* project id or number.
704709
* </pre>
705710
*
706711
* <code>
@@ -724,7 +729,8 @@ public Builder setParent(java.lang.String value) {
724729
*
725730
* <pre>
726731
* Required. The location and project in which this Job should be created.
727-
* Format: projects/{project}/locations/{location}
732+
* Format: projects/{project}/locations/{location}, where {project} can be
733+
* project id or number.
728734
* </pre>
729735
*
730736
* <code>
@@ -744,7 +750,8 @@ public Builder clearParent() {
744750
*
745751
* <pre>
746752
* Required. The location and project in which this Job should be created.
747-
* Format: projects/{project}/locations/{location}
753+
* Format: projects/{project}/locations/{location}, where {project} can be
754+
* project id or number.
748755
* </pre>
749756
*
750757
* <code>

java-run/proto-google-cloud-run-v2/src/main/java/com/google/cloud/run/v2/CreateJobRequestOrBuilder.java

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ public interface CreateJobRequestOrBuilder
2828
*
2929
* <pre>
3030
* Required. The location and project in which this Job should be created.
31-
* Format: projects/{project}/locations/{location}
31+
* Format: projects/{project}/locations/{location}, where {project} can be
32+
* project id or number.
3233
* </pre>
3334
*
3435
* <code>
@@ -43,7 +44,8 @@ public interface CreateJobRequestOrBuilder
4344
*
4445
* <pre>
4546
* Required. The location and project in which this Job should be created.
46-
* Format: projects/{project}/locations/{location}
47+
* Format: projects/{project}/locations/{location}, where {project} can be
48+
* project id or number.
4749
* </pre>
4850
*
4951
* <code>

0 commit comments

Comments
 (0)