google-cloud-build-v1 0.8.1 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f7e16e360b04ea10c108155fd885b4995ce7df3bd603a58ae131efe645d79abc
4
- data.tar.gz: ac70d479d3a999186589d43cab4de7eb7b9015d7c1af20d9817cef5750cde0e9
3
+ metadata.gz: 8cd5bcabb5f8a6f69cbf6c06611f1a267f80d07eb13ea2ba8792e3580c4829ee
4
+ data.tar.gz: ce642880f7e6a974c5571cd6d9d14bd3b42b720dab01388b3f52a04c1a503aaf
5
5
  SHA512:
6
- metadata.gz: 8f8e9c9cee84ee91e7ea588f185f4fba50f138689109514ee6b999dfbf08215e8dbb90f7ff9298411fcaf9068fbadf27b689f2d94214dd6b4cc1b0b631de9604
7
- data.tar.gz: 6cc2c643cc7a3c193662304222a79cc20e7d3b6b6056d1a13d1c4220bc26ec47b90bac5e3941af39c4265edba868b4bcf8efa3701355f25d35d69fef01b88171
6
+ metadata.gz: add5feb686114a8e97dbdf6393e9e4c11d75caf301dd294994edf9832555227698248bf3b4a4909af92ab804489008d0b516f779fd8f5a2422eacb03977c353c
7
+ data.tar.gz: d5d5d9d4a211bd5f9d472f26d3264c6603b850be82d021c04ebae5db560eabb2940c04456bf7de570c396918b2b42d170772aa49af7ce1972ee222f610e8f0d6
@@ -48,13 +48,12 @@ module Google
48
48
  # See {::Google::Cloud::Build::V1::CloudBuild::Client::Configuration}
49
49
  # for a description of the configuration fields.
50
50
  #
51
- # ## Example
51
+ # @example
52
52
  #
53
- # To modify the configuration for all CloudBuild clients:
54
- #
55
- # ::Google::Cloud::Build::V1::CloudBuild::Client.configure do |config|
56
- # config.timeout = 10.0
57
- # end
53
+ # # Modify the configuration for all CloudBuild clients
54
+ # ::Google::Cloud::Build::V1::CloudBuild::Client.configure do |config|
55
+ # config.timeout = 10.0
56
+ # end
58
57
  #
59
58
  # @yield [config] Configure the Client client.
60
59
  # @yieldparam config [Client::Configuration]
@@ -154,19 +153,15 @@ module Google
154
153
  ##
155
154
  # Create a new CloudBuild client object.
156
155
  #
157
- # ## Examples
158
- #
159
- # To create a new CloudBuild client with the default
160
- # configuration:
161
- #
162
- # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new
156
+ # @example
163
157
  #
164
- # To create a new CloudBuild client with a custom
165
- # configuration:
158
+ # # Create a client using the default configuration
159
+ # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new
166
160
  #
167
- # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new do |config|
168
- # config.timeout = 10.0
169
- # end
161
+ # # Create a client using a custom configuration
162
+ # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new do |config|
163
+ # config.timeout = 10.0
164
+ # end
170
165
  #
171
166
  # @yield [config] Configure the CloudBuild client.
172
167
  # @yieldparam config [Client::Configuration]
@@ -186,10 +181,9 @@ module Google
186
181
 
187
182
  # Create credentials
188
183
  credentials = @config.credentials
189
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
184
+ # Use self-signed JWT if the endpoint is unchanged from default,
190
185
  # but only if the default endpoint does not have a region prefix.
191
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
192
- @config.endpoint == Client.configure.endpoint &&
186
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
193
187
  !@config.endpoint.split(".").first.include?("-")
194
188
  credentials ||= Credentials.default scope: @config.scope,
195
189
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -286,7 +280,9 @@ module Google
286
280
  options.apply_defaults timeout: @config.rpcs.create_build.timeout,
287
281
  metadata: metadata,
288
282
  retry_policy: @config.rpcs.create_build.retry_policy
289
- options.apply_defaults metadata: @config.metadata,
283
+
284
+ options.apply_defaults timeout: @config.timeout,
285
+ metadata: @config.metadata,
290
286
  retry_policy: @config.retry_policy
291
287
 
292
288
  @cloud_build_stub.call_rpc :create_build, request, options: options do |response, operation|
@@ -362,7 +358,9 @@ module Google
362
358
  options.apply_defaults timeout: @config.rpcs.get_build.timeout,
363
359
  metadata: metadata,
364
360
  retry_policy: @config.rpcs.get_build.retry_policy
365
- options.apply_defaults metadata: @config.metadata,
361
+
362
+ options.apply_defaults timeout: @config.timeout,
363
+ metadata: @config.metadata,
366
364
  retry_policy: @config.retry_policy
367
365
 
368
366
  @cloud_build_stub.call_rpc :get_build, request, options: options do |response, operation|
@@ -448,7 +446,9 @@ module Google
448
446
  options.apply_defaults timeout: @config.rpcs.list_builds.timeout,
449
447
  metadata: metadata,
450
448
  retry_policy: @config.rpcs.list_builds.retry_policy
451
- options.apply_defaults metadata: @config.metadata,
449
+
450
+ options.apply_defaults timeout: @config.timeout,
451
+ metadata: @config.metadata,
452
452
  retry_policy: @config.retry_policy
453
453
 
454
454
  @cloud_build_stub.call_rpc :list_builds, request, options: options do |response, operation|
@@ -521,7 +521,9 @@ module Google
521
521
  options.apply_defaults timeout: @config.rpcs.cancel_build.timeout,
522
522
  metadata: metadata,
523
523
  retry_policy: @config.rpcs.cancel_build.retry_policy
524
- options.apply_defaults metadata: @config.metadata,
524
+
525
+ options.apply_defaults timeout: @config.timeout,
526
+ metadata: @config.metadata,
525
527
  retry_policy: @config.retry_policy
526
528
 
527
529
  @cloud_build_stub.call_rpc :cancel_build, request, options: options do |response, operation|
@@ -619,7 +621,9 @@ module Google
619
621
  options.apply_defaults timeout: @config.rpcs.retry_build.timeout,
620
622
  metadata: metadata,
621
623
  retry_policy: @config.rpcs.retry_build.retry_policy
622
- options.apply_defaults metadata: @config.metadata,
624
+
625
+ options.apply_defaults timeout: @config.timeout,
626
+ metadata: @config.metadata,
623
627
  retry_policy: @config.retry_policy
624
628
 
625
629
  @cloud_build_stub.call_rpc :retry_build, request, options: options do |response, operation|
@@ -631,6 +635,83 @@ module Google
631
635
  raise ::Google::Cloud::Error.from_error(e)
632
636
  end
633
637
 
638
+ ##
639
+ # Approves or rejects a pending build.
640
+ #
641
+ # If approved, the returned LRO will be analogous to the LRO returned from
642
+ # a CreateBuild call.
643
+ #
644
+ # If rejected, the returned LRO will be immediately done.
645
+ #
646
+ # @overload approve_build(request, options = nil)
647
+ # Pass arguments to `approve_build` via a request object, either of type
648
+ # {::Google::Cloud::Build::V1::ApproveBuildRequest} or an equivalent Hash.
649
+ #
650
+ # @param request [::Google::Cloud::Build::V1::ApproveBuildRequest, ::Hash]
651
+ # A request object representing the call parameters. Required. To specify no
652
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
653
+ # @param options [::Gapic::CallOptions, ::Hash]
654
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
655
+ #
656
+ # @overload approve_build(name: nil, approval_result: nil)
657
+ # Pass arguments to `approve_build` via keyword arguments. Note that at
658
+ # least one keyword argument is required. To specify no parameters, or to keep all
659
+ # the default parameter values, pass an empty Hash as a request object (see above).
660
+ #
661
+ # @param name [::String]
662
+ # Required. Name of the target build.
663
+ # For example: "projects/\\{$project_id}/builds/\\{$build_id}"
664
+ # @param approval_result [::Google::Cloud::Build::V1::ApprovalResult, ::Hash]
665
+ # Approval decision and metadata.
666
+ #
667
+ # @yield [response, operation] Access the result along with the RPC operation
668
+ # @yieldparam response [::Gapic::Operation]
669
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
670
+ #
671
+ # @return [::Gapic::Operation]
672
+ #
673
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
674
+ #
675
+ def approve_build request, options = nil
676
+ raise ::ArgumentError, "request must be provided" if request.nil?
677
+
678
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Build::V1::ApproveBuildRequest
679
+
680
+ # Converts hash and nil to an options object
681
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
682
+
683
+ # Customize the options with defaults
684
+ metadata = @config.rpcs.approve_build.metadata.to_h
685
+
686
+ # Set x-goog-api-client and x-goog-user-project headers
687
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
688
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
689
+ gapic_version: ::Google::Cloud::Build::V1::VERSION
690
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
691
+
692
+ header_params = {
693
+ "name" => request.name
694
+ }
695
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
696
+ metadata[:"x-goog-request-params"] ||= request_params_header
697
+
698
+ options.apply_defaults timeout: @config.rpcs.approve_build.timeout,
699
+ metadata: metadata,
700
+ retry_policy: @config.rpcs.approve_build.retry_policy
701
+
702
+ options.apply_defaults timeout: @config.timeout,
703
+ metadata: @config.metadata,
704
+ retry_policy: @config.retry_policy
705
+
706
+ @cloud_build_stub.call_rpc :approve_build, request, options: options do |response, operation|
707
+ response = ::Gapic::Operation.new response, @operations_client, options: options
708
+ yield response, operation if block_given?
709
+ return response
710
+ end
711
+ rescue ::GRPC::BadStatus => e
712
+ raise ::Google::Cloud::Error.from_error(e)
713
+ end
714
+
634
715
  ##
635
716
  # Creates a new `BuildTrigger`.
636
717
  #
@@ -693,7 +774,9 @@ module Google
693
774
  options.apply_defaults timeout: @config.rpcs.create_build_trigger.timeout,
694
775
  metadata: metadata,
695
776
  retry_policy: @config.rpcs.create_build_trigger.retry_policy
696
- options.apply_defaults metadata: @config.metadata,
777
+
778
+ options.apply_defaults timeout: @config.timeout,
779
+ metadata: @config.metadata,
697
780
  retry_policy: @config.retry_policy
698
781
 
699
782
  @cloud_build_stub.call_rpc :create_build_trigger, request, options: options do |response, operation|
@@ -767,7 +850,9 @@ module Google
767
850
  options.apply_defaults timeout: @config.rpcs.get_build_trigger.timeout,
768
851
  metadata: metadata,
769
852
  retry_policy: @config.rpcs.get_build_trigger.retry_policy
770
- options.apply_defaults metadata: @config.metadata,
853
+
854
+ options.apply_defaults timeout: @config.timeout,
855
+ metadata: @config.metadata,
771
856
  retry_policy: @config.retry_policy
772
857
 
773
858
  @cloud_build_stub.call_rpc :get_build_trigger, request, options: options do |response, operation|
@@ -842,7 +927,9 @@ module Google
842
927
  options.apply_defaults timeout: @config.rpcs.list_build_triggers.timeout,
843
928
  metadata: metadata,
844
929
  retry_policy: @config.rpcs.list_build_triggers.retry_policy
845
- options.apply_defaults metadata: @config.metadata,
930
+
931
+ options.apply_defaults timeout: @config.timeout,
932
+ metadata: @config.metadata,
846
933
  retry_policy: @config.retry_policy
847
934
 
848
935
  @cloud_build_stub.call_rpc :list_build_triggers, request, options: options do |response, operation|
@@ -917,7 +1004,9 @@ module Google
917
1004
  options.apply_defaults timeout: @config.rpcs.delete_build_trigger.timeout,
918
1005
  metadata: metadata,
919
1006
  retry_policy: @config.rpcs.delete_build_trigger.retry_policy
920
- options.apply_defaults metadata: @config.metadata,
1007
+
1008
+ options.apply_defaults timeout: @config.timeout,
1009
+ metadata: @config.metadata,
921
1010
  retry_policy: @config.retry_policy
922
1011
 
923
1012
  @cloud_build_stub.call_rpc :delete_build_trigger, request, options: options do |response, operation|
@@ -990,7 +1079,9 @@ module Google
990
1079
  options.apply_defaults timeout: @config.rpcs.update_build_trigger.timeout,
991
1080
  metadata: metadata,
992
1081
  retry_policy: @config.rpcs.update_build_trigger.retry_policy
993
- options.apply_defaults metadata: @config.metadata,
1082
+
1083
+ options.apply_defaults timeout: @config.timeout,
1084
+ metadata: @config.metadata,
994
1085
  retry_policy: @config.retry_policy
995
1086
 
996
1087
  @cloud_build_stub.call_rpc :update_build_trigger, request, options: options do |response, operation|
@@ -1064,7 +1155,9 @@ module Google
1064
1155
  options.apply_defaults timeout: @config.rpcs.run_build_trigger.timeout,
1065
1156
  metadata: metadata,
1066
1157
  retry_policy: @config.rpcs.run_build_trigger.retry_policy
1067
- options.apply_defaults metadata: @config.metadata,
1158
+
1159
+ options.apply_defaults timeout: @config.timeout,
1160
+ metadata: @config.metadata,
1068
1161
  retry_policy: @config.retry_policy
1069
1162
 
1070
1163
  @cloud_build_stub.call_rpc :run_build_trigger, request, options: options do |response, operation|
@@ -1142,7 +1235,9 @@ module Google
1142
1235
  options.apply_defaults timeout: @config.rpcs.receive_trigger_webhook.timeout,
1143
1236
  metadata: metadata,
1144
1237
  retry_policy: @config.rpcs.receive_trigger_webhook.retry_policy
1145
- options.apply_defaults metadata: @config.metadata,
1238
+
1239
+ options.apply_defaults timeout: @config.timeout,
1240
+ metadata: @config.metadata,
1146
1241
  retry_policy: @config.retry_policy
1147
1242
 
1148
1243
  @cloud_build_stub.call_rpc :receive_trigger_webhook, request, options: options do |response, operation|
@@ -1154,9 +1249,7 @@ module Google
1154
1249
  end
1155
1250
 
1156
1251
  ##
1157
- # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
1158
- #
1159
- # This API is experimental.
1252
+ # Creates a `WorkerPool`.
1160
1253
  #
1161
1254
  # @overload create_worker_pool(request, options = nil)
1162
1255
  # Pass arguments to `create_worker_pool` via a request object, either of type
@@ -1168,21 +1261,31 @@ module Google
1168
1261
  # @param options [::Gapic::CallOptions, ::Hash]
1169
1262
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1170
1263
  #
1171
- # @overload create_worker_pool(parent: nil, worker_pool: nil)
1264
+ # @overload create_worker_pool(parent: nil, worker_pool: nil, worker_pool_id: nil, validate_only: nil)
1172
1265
  # Pass arguments to `create_worker_pool` via keyword arguments. Note that at
1173
1266
  # least one keyword argument is required. To specify no parameters, or to keep all
1174
1267
  # the default parameter values, pass an empty Hash as a request object (see above).
1175
1268
  #
1176
1269
  # @param parent [::String]
1177
- # ID of the parent project.
1270
+ # Required. The parent resource where this worker pool will be created.
1271
+ # Format: `projects/{project}/locations/{location}`.
1178
1272
  # @param worker_pool [::Google::Cloud::Build::V1::WorkerPool, ::Hash]
1179
- # `WorkerPool` resource to create.
1273
+ # Required. `WorkerPool` resource to create.
1274
+ # @param worker_pool_id [::String]
1275
+ # Required. Immutable. The ID to use for the `WorkerPool`, which will become
1276
+ # the final component of the resource name.
1277
+ #
1278
+ # This value should be 1-63 characters, and valid characters
1279
+ # are /[a-z][0-9]-/.
1280
+ # @param validate_only [::Boolean]
1281
+ # If set, validate the request and preview the response, but do not actually
1282
+ # post it.
1180
1283
  #
1181
1284
  # @yield [response, operation] Access the result along with the RPC operation
1182
- # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
1285
+ # @yieldparam response [::Gapic::Operation]
1183
1286
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1184
1287
  #
1185
- # @return [::Google::Cloud::Build::V1::WorkerPool]
1288
+ # @return [::Gapic::Operation]
1186
1289
  #
1187
1290
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1188
1291
  #
@@ -1203,13 +1306,22 @@ module Google
1203
1306
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1204
1307
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1205
1308
 
1309
+ header_params = {
1310
+ "parent" => request.parent
1311
+ }
1312
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1313
+ metadata[:"x-goog-request-params"] ||= request_params_header
1314
+
1206
1315
  options.apply_defaults timeout: @config.rpcs.create_worker_pool.timeout,
1207
1316
  metadata: metadata,
1208
1317
  retry_policy: @config.rpcs.create_worker_pool.retry_policy
1209
- options.apply_defaults metadata: @config.metadata,
1318
+
1319
+ options.apply_defaults timeout: @config.timeout,
1320
+ metadata: @config.metadata,
1210
1321
  retry_policy: @config.retry_policy
1211
1322
 
1212
1323
  @cloud_build_stub.call_rpc :create_worker_pool, request, options: options do |response, operation|
1324
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1213
1325
  yield response, operation if block_given?
1214
1326
  return response
1215
1327
  end
@@ -1218,9 +1330,7 @@ module Google
1218
1330
  end
1219
1331
 
1220
1332
  ##
1221
- # Returns information about a `WorkerPool`.
1222
- #
1223
- # This API is experimental.
1333
+ # Returns details of a `WorkerPool`.
1224
1334
  #
1225
1335
  # @overload get_worker_pool(request, options = nil)
1226
1336
  # Pass arguments to `get_worker_pool` via a request object, either of type
@@ -1238,8 +1348,8 @@ module Google
1238
1348
  # the default parameter values, pass an empty Hash as a request object (see above).
1239
1349
  #
1240
1350
  # @param name [::String]
1241
- # The field will contain name of the resource requested, for example:
1242
- # "projects/project-1/workerPools/workerpool-name"
1351
+ # Required. The name of the `WorkerPool` to retrieve.
1352
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1243
1353
  #
1244
1354
  # @yield [response, operation] Access the result along with the RPC operation
1245
1355
  # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
@@ -1266,10 +1376,18 @@ module Google
1266
1376
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1267
1377
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1268
1378
 
1379
+ header_params = {
1380
+ "name" => request.name
1381
+ }
1382
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1383
+ metadata[:"x-goog-request-params"] ||= request_params_header
1384
+
1269
1385
  options.apply_defaults timeout: @config.rpcs.get_worker_pool.timeout,
1270
1386
  metadata: metadata,
1271
1387
  retry_policy: @config.rpcs.get_worker_pool.retry_policy
1272
- options.apply_defaults metadata: @config.metadata,
1388
+
1389
+ options.apply_defaults timeout: @config.timeout,
1390
+ metadata: @config.metadata,
1273
1391
  retry_policy: @config.retry_policy
1274
1392
 
1275
1393
  @cloud_build_stub.call_rpc :get_worker_pool, request, options: options do |response, operation|
@@ -1281,9 +1399,7 @@ module Google
1281
1399
  end
1282
1400
 
1283
1401
  ##
1284
- # Deletes a `WorkerPool` by its project ID and WorkerPool name.
1285
- #
1286
- # This API is experimental.
1402
+ # Deletes a `WorkerPool`.
1287
1403
  #
1288
1404
  # @overload delete_worker_pool(request, options = nil)
1289
1405
  # Pass arguments to `delete_worker_pool` via a request object, either of type
@@ -1295,20 +1411,30 @@ module Google
1295
1411
  # @param options [::Gapic::CallOptions, ::Hash]
1296
1412
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1297
1413
  #
1298
- # @overload delete_worker_pool(name: nil)
1414
+ # @overload delete_worker_pool(name: nil, etag: nil, allow_missing: nil, validate_only: nil)
1299
1415
  # Pass arguments to `delete_worker_pool` via keyword arguments. Note that at
1300
1416
  # least one keyword argument is required. To specify no parameters, or to keep all
1301
1417
  # the default parameter values, pass an empty Hash as a request object (see above).
1302
1418
  #
1303
1419
  # @param name [::String]
1304
- # The field will contain name of the resource requested, for example:
1305
- # "projects/project-1/workerPools/workerpool-name"
1420
+ # Required. The name of the `WorkerPool` to delete.
1421
+ # Format:
1422
+ # `projects/{project}/locations/{workerPool}/workerPools/{workerPool}`.
1423
+ # @param etag [::String]
1424
+ # Optional. If this is provided, it must match the server's etag on the
1425
+ # workerpool for the request to be processed.
1426
+ # @param allow_missing [::Boolean]
1427
+ # If set to true, and the `WorkerPool` is not found, the request will succeed
1428
+ # but no action will be taken on the server.
1429
+ # @param validate_only [::Boolean]
1430
+ # If set, validate the request and preview the response, but do not actually
1431
+ # post it.
1306
1432
  #
1307
1433
  # @yield [response, operation] Access the result along with the RPC operation
1308
- # @yieldparam response [::Google::Protobuf::Empty]
1434
+ # @yieldparam response [::Gapic::Operation]
1309
1435
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1310
1436
  #
1311
- # @return [::Google::Protobuf::Empty]
1437
+ # @return [::Gapic::Operation]
1312
1438
  #
1313
1439
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1314
1440
  #
@@ -1329,13 +1455,22 @@ module Google
1329
1455
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1330
1456
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1331
1457
 
1458
+ header_params = {
1459
+ "name" => request.name
1460
+ }
1461
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1462
+ metadata[:"x-goog-request-params"] ||= request_params_header
1463
+
1332
1464
  options.apply_defaults timeout: @config.rpcs.delete_worker_pool.timeout,
1333
1465
  metadata: metadata,
1334
1466
  retry_policy: @config.rpcs.delete_worker_pool.retry_policy
1335
- options.apply_defaults metadata: @config.metadata,
1467
+
1468
+ options.apply_defaults timeout: @config.timeout,
1469
+ metadata: @config.metadata,
1336
1470
  retry_policy: @config.retry_policy
1337
1471
 
1338
1472
  @cloud_build_stub.call_rpc :delete_worker_pool, request, options: options do |response, operation|
1473
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1339
1474
  yield response, operation if block_given?
1340
1475
  return response
1341
1476
  end
@@ -1344,9 +1479,7 @@ module Google
1344
1479
  end
1345
1480
 
1346
1481
  ##
1347
- # Update a `WorkerPool`.
1348
- #
1349
- # This API is experimental.
1482
+ # Updates a `WorkerPool`.
1350
1483
  #
1351
1484
  # @overload update_worker_pool(request, options = nil)
1352
1485
  # Pass arguments to `update_worker_pool` via a request object, either of type
@@ -1358,22 +1491,27 @@ module Google
1358
1491
  # @param options [::Gapic::CallOptions, ::Hash]
1359
1492
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1360
1493
  #
1361
- # @overload update_worker_pool(name: nil, worker_pool: nil)
1494
+ # @overload update_worker_pool(worker_pool: nil, update_mask: nil, validate_only: nil)
1362
1495
  # Pass arguments to `update_worker_pool` via keyword arguments. Note that at
1363
1496
  # least one keyword argument is required. To specify no parameters, or to keep all
1364
1497
  # the default parameter values, pass an empty Hash as a request object (see above).
1365
1498
  #
1366
- # @param name [::String]
1367
- # The field will contain name of the resource requested, for example:
1368
- # "projects/project-1/workerPools/workerpool-name"
1369
1499
  # @param worker_pool [::Google::Cloud::Build::V1::WorkerPool, ::Hash]
1370
- # `WorkerPool` resource to update.
1500
+ # Required. The `WorkerPool` to update.
1501
+ #
1502
+ # The `name` field is used to identify the `WorkerPool` to update.
1503
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1504
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1505
+ # A mask specifying which fields in `worker_pool` to update.
1506
+ # @param validate_only [::Boolean]
1507
+ # If set, validate the request and preview the response, but do not actually
1508
+ # post it.
1371
1509
  #
1372
1510
  # @yield [response, operation] Access the result along with the RPC operation
1373
- # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
1511
+ # @yieldparam response [::Gapic::Operation]
1374
1512
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1375
1513
  #
1376
- # @return [::Google::Cloud::Build::V1::WorkerPool]
1514
+ # @return [::Gapic::Operation]
1377
1515
  #
1378
1516
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1379
1517
  #
@@ -1394,13 +1532,22 @@ module Google
1394
1532
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1395
1533
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1396
1534
 
1535
+ header_params = {
1536
+ "worker_pool.name" => request.worker_pool.name
1537
+ }
1538
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1539
+ metadata[:"x-goog-request-params"] ||= request_params_header
1540
+
1397
1541
  options.apply_defaults timeout: @config.rpcs.update_worker_pool.timeout,
1398
1542
  metadata: metadata,
1399
1543
  retry_policy: @config.rpcs.update_worker_pool.retry_policy
1400
- options.apply_defaults metadata: @config.metadata,
1544
+
1545
+ options.apply_defaults timeout: @config.timeout,
1546
+ metadata: @config.metadata,
1401
1547
  retry_policy: @config.retry_policy
1402
1548
 
1403
1549
  @cloud_build_stub.call_rpc :update_worker_pool, request, options: options do |response, operation|
1550
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1404
1551
  yield response, operation if block_given?
1405
1552
  return response
1406
1553
  end
@@ -1409,9 +1556,7 @@ module Google
1409
1556
  end
1410
1557
 
1411
1558
  ##
1412
- # List project's `WorkerPools`.
1413
- #
1414
- # This API is experimental.
1559
+ # Lists `WorkerPool`s.
1415
1560
  #
1416
1561
  # @overload list_worker_pools(request, options = nil)
1417
1562
  # Pass arguments to `list_worker_pools` via a request object, either of type
@@ -1423,19 +1568,26 @@ module Google
1423
1568
  # @param options [::Gapic::CallOptions, ::Hash]
1424
1569
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1425
1570
  #
1426
- # @overload list_worker_pools(parent: nil)
1571
+ # @overload list_worker_pools(parent: nil, page_size: nil, page_token: nil)
1427
1572
  # Pass arguments to `list_worker_pools` via keyword arguments. Note that at
1428
1573
  # least one keyword argument is required. To specify no parameters, or to keep all
1429
1574
  # the default parameter values, pass an empty Hash as a request object (see above).
1430
1575
  #
1431
1576
  # @param parent [::String]
1432
- # ID of the parent project.
1577
+ # Required. The parent of the collection of `WorkerPools`.
1578
+ # Format: `projects/{project}/locations/{location}`.
1579
+ # @param page_size [::Integer]
1580
+ # The maximum number of `WorkerPool`s to return. The service may return
1581
+ # fewer than this value. If omitted, the server will use a sensible default.
1582
+ # @param page_token [::String]
1583
+ # A page token, received from a previous `ListWorkerPools` call. Provide this
1584
+ # to retrieve the subsequent page.
1433
1585
  #
1434
1586
  # @yield [response, operation] Access the result along with the RPC operation
1435
- # @yieldparam response [::Google::Cloud::Build::V1::ListWorkerPoolsResponse]
1587
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Build::V1::WorkerPool>]
1436
1588
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1437
1589
  #
1438
- # @return [::Google::Cloud::Build::V1::ListWorkerPoolsResponse]
1590
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Build::V1::WorkerPool>]
1439
1591
  #
1440
1592
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1441
1593
  #
@@ -1456,13 +1608,22 @@ module Google
1456
1608
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1457
1609
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1458
1610
 
1611
+ header_params = {
1612
+ "parent" => request.parent
1613
+ }
1614
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1615
+ metadata[:"x-goog-request-params"] ||= request_params_header
1616
+
1459
1617
  options.apply_defaults timeout: @config.rpcs.list_worker_pools.timeout,
1460
1618
  metadata: metadata,
1461
1619
  retry_policy: @config.rpcs.list_worker_pools.retry_policy
1462
- options.apply_defaults metadata: @config.metadata,
1620
+
1621
+ options.apply_defaults timeout: @config.timeout,
1622
+ metadata: @config.metadata,
1463
1623
  retry_policy: @config.retry_policy
1464
1624
 
1465
1625
  @cloud_build_stub.call_rpc :list_worker_pools, request, options: options do |response, operation|
1626
+ response = ::Gapic::PagedEnumerable.new @cloud_build_stub, :list_worker_pools, request, response, operation, options
1466
1627
  yield response, operation if block_given?
1467
1628
  return response
1468
1629
  end
@@ -1483,22 +1644,21 @@ module Google
1483
1644
  # Configuration can be applied globally to all clients, or to a single client
1484
1645
  # on construction.
1485
1646
  #
1486
- # # Examples
1487
- #
1488
- # To modify the global config, setting the timeout for create_build
1489
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1647
+ # @example
1490
1648
  #
1491
- # ::Google::Cloud::Build::V1::CloudBuild::Client.configure do |config|
1492
- # config.timeout = 10.0
1493
- # config.rpcs.create_build.timeout = 20.0
1494
- # end
1649
+ # # Modify the global config, setting the timeout for
1650
+ # # create_build to 20 seconds,
1651
+ # # and all remaining timeouts to 10 seconds.
1652
+ # ::Google::Cloud::Build::V1::CloudBuild::Client.configure do |config|
1653
+ # config.timeout = 10.0
1654
+ # config.rpcs.create_build.timeout = 20.0
1655
+ # end
1495
1656
  #
1496
- # To apply the above configuration only to a new client:
1497
- #
1498
- # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new do |config|
1499
- # config.timeout = 10.0
1500
- # config.rpcs.create_build.timeout = 20.0
1501
- # end
1657
+ # # Apply the above configuration only to a new client.
1658
+ # client = ::Google::Cloud::Build::V1::CloudBuild::Client.new do |config|
1659
+ # config.timeout = 10.0
1660
+ # config.rpcs.create_build.timeout = 20.0
1661
+ # end
1502
1662
  #
1503
1663
  # @!attribute [rw] endpoint
1504
1664
  # The hostname or hostname:port of the service endpoint.
@@ -1632,6 +1792,11 @@ module Google
1632
1792
  #
1633
1793
  attr_reader :retry_build
1634
1794
  ##
1795
+ # RPC-specific configuration for `approve_build`
1796
+ # @return [::Gapic::Config::Method]
1797
+ #
1798
+ attr_reader :approve_build
1799
+ ##
1635
1800
  # RPC-specific configuration for `create_build_trigger`
1636
1801
  # @return [::Gapic::Config::Method]
1637
1802
  #
@@ -1704,6 +1869,8 @@ module Google
1704
1869
  @cancel_build = ::Gapic::Config::Method.new cancel_build_config
1705
1870
  retry_build_config = parent_rpcs.retry_build if parent_rpcs.respond_to? :retry_build
1706
1871
  @retry_build = ::Gapic::Config::Method.new retry_build_config
1872
+ approve_build_config = parent_rpcs.approve_build if parent_rpcs.respond_to? :approve_build
1873
+ @approve_build = ::Gapic::Config::Method.new approve_build_config
1707
1874
  create_build_trigger_config = parent_rpcs.create_build_trigger if parent_rpcs.respond_to? :create_build_trigger
1708
1875
  @create_build_trigger = ::Gapic::Config::Method.new create_build_trigger_config
1709
1876
  get_build_trigger_config = parent_rpcs.get_build_trigger if parent_rpcs.respond_to? :get_build_trigger