google-cloud-build-v1 0.7.0 → 0.9.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: 295fb0e2fcc4c309c8014a6a05ad2f975f3e1aebcab53d69019dd883333e0b01
4
- data.tar.gz: 19a9409dd2d844c80cc4b6a04203d91451f364201373ed048c53dcc9db109301
3
+ metadata.gz: 250b682a118dc351f44f5d77ee7b28ee7408d705a2eea2c655f2329d6a35ef41
4
+ data.tar.gz: 0a59fde0694287e54abaccd1355a73ebaae409a78e3d4e7fd93573627eaf0cea
5
5
  SHA512:
6
- metadata.gz: d4cb40c9ea7c8a10fc4995190be6c1ecff4e0bdb5203155f55df2fb8e28a338ef22f53e6c917a83c70b4b2414be9dfe8e55d7235b56374096a1d3fb9b2af28cb
7
- data.tar.gz: 738b3aca458adb571f047e2fb1fa921f43c086eb27de8727b3542e8b639cd8b53afa3a032eca108f6470008a081622ba9f4b0074a94a6a32cf834bf409d96d60
6
+ metadata.gz: 49970a22f3b61969d431b1844a0a66c0f8632b2c46a299c88673197a508ed285af7299e7eb2f43232102a5cecb609495deafae54ff7224be95eb004078822f1e
7
+ data.tar.gz: 64d460cdf291c78aeb9e04cfee9cc3518efceb175b1b9298e174c0985da9d2d0656a8d9c1441cc84e75f150d987c34ba7040457a11a9f1f3c90b34b3d4b4927e
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-build-v1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::Build::V1::CloudBuild::Credentials}):
68
68
 
69
- 1. `CLOUD_BUILD_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `CLOUD_BUILD_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `CLOUD_BUILD_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `CLOUD_BUILD_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/build/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Build::V1::CloudBuild::Client.new
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/build/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Build::V1::CloudBuild::Client.new do |config|
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/build/v1"
data/README.md CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/build/v1"
34
34
 
35
35
  client = ::Google::Cloud::Build::V1::CloudBuild::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::Build::V1::CreateBuildRequest.new # (request fields as keyword arguments...)
37
37
  response = client.create_build request
38
38
  ```
39
39
 
@@ -76,18 +76,12 @@ module Google
76
76
 
77
77
  default_config.rpcs.get_build.timeout = 600.0
78
78
  default_config.rpcs.get_build.retry_policy = {
79
- initial_delay: 0.1,
80
- max_delay: 60.0,
81
- multiplier: 1.3,
82
- retry_codes: [14, 4]
79
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
83
80
  }
84
81
 
85
82
  default_config.rpcs.list_builds.timeout = 600.0
86
83
  default_config.rpcs.list_builds.retry_policy = {
87
- initial_delay: 0.1,
88
- max_delay: 60.0,
89
- multiplier: 1.3,
90
- retry_codes: [14, 4]
84
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
91
85
  }
92
86
 
93
87
  default_config.rpcs.cancel_build.timeout = 600.0
@@ -98,26 +92,17 @@ module Google
98
92
 
99
93
  default_config.rpcs.get_build_trigger.timeout = 600.0
100
94
  default_config.rpcs.get_build_trigger.retry_policy = {
101
- initial_delay: 0.1,
102
- max_delay: 60.0,
103
- multiplier: 1.3,
104
- retry_codes: [14, 4]
95
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
105
96
  }
106
97
 
107
98
  default_config.rpcs.list_build_triggers.timeout = 600.0
108
99
  default_config.rpcs.list_build_triggers.retry_policy = {
109
- initial_delay: 0.1,
110
- max_delay: 60.0,
111
- multiplier: 1.3,
112
- retry_codes: [14, 4]
100
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
113
101
  }
114
102
 
115
103
  default_config.rpcs.delete_build_trigger.timeout = 600.0
116
104
  default_config.rpcs.delete_build_trigger.retry_policy = {
117
- initial_delay: 0.1,
118
- max_delay: 60.0,
119
- multiplier: 1.3,
120
- retry_codes: [14, 4]
105
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
121
106
  }
122
107
 
123
108
  default_config.rpcs.update_build_trigger.timeout = 600.0
@@ -128,10 +113,7 @@ module Google
128
113
 
129
114
  default_config.rpcs.get_worker_pool.timeout = 600.0
130
115
  default_config.rpcs.get_worker_pool.retry_policy = {
131
- initial_delay: 0.1,
132
- max_delay: 60.0,
133
- multiplier: 1.3,
134
- retry_codes: [14, 4]
116
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
135
117
  }
136
118
 
137
119
  default_config.rpcs.delete_worker_pool.timeout = 600.0
@@ -140,10 +122,7 @@ module Google
140
122
 
141
123
  default_config.rpcs.list_worker_pools.timeout = 600.0
142
124
  default_config.rpcs.list_worker_pools.retry_policy = {
143
- initial_delay: 0.1,
144
- max_delay: 60.0,
145
- multiplier: 1.3,
146
- retry_codes: [14, 4]
125
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
147
126
  }
148
127
 
149
128
  default_config
@@ -214,7 +193,7 @@ module Google
214
193
  !@config.endpoint.split(".").first.include?("-")
215
194
  credentials ||= Credentials.default scope: @config.scope,
216
195
  enable_self_signed_jwt: enable_self_signed_jwt
217
- if credentials.is_a?(String) || credentials.is_a?(Hash)
196
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
218
197
  credentials = Credentials.new credentials, scope: @config.scope
219
198
  end
220
199
  @quota_project_id = @config.quota_project
@@ -667,11 +646,14 @@ module Google
667
646
  # @param options [::Gapic::CallOptions, ::Hash]
668
647
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
669
648
  #
670
- # @overload create_build_trigger(project_id: nil, trigger: nil)
649
+ # @overload create_build_trigger(parent: nil, project_id: nil, trigger: nil)
671
650
  # Pass arguments to `create_build_trigger` via keyword arguments. Note that at
672
651
  # least one keyword argument is required. To specify no parameters, or to keep all
673
652
  # the default parameter values, pass an empty Hash as a request object (see above).
674
653
  #
654
+ # @param parent [::String]
655
+ # The parent resource where this trigger will be created.
656
+ # Format: `projects/{project}/locations/{location}`
675
657
  # @param project_id [::String]
676
658
  # Required. ID of the project for which to configure automatic builds.
677
659
  # @param trigger [::Google::Cloud::Build::V1::BuildTrigger, ::Hash]
@@ -737,11 +719,14 @@ module Google
737
719
  # @param options [::Gapic::CallOptions, ::Hash]
738
720
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
739
721
  #
740
- # @overload get_build_trigger(project_id: nil, trigger_id: nil)
722
+ # @overload get_build_trigger(name: nil, project_id: nil, trigger_id: nil)
741
723
  # Pass arguments to `get_build_trigger` via keyword arguments. Note that at
742
724
  # least one keyword argument is required. To specify no parameters, or to keep all
743
725
  # the default parameter values, pass an empty Hash as a request object (see above).
744
726
  #
727
+ # @param name [::String]
728
+ # The name of the `Trigger` to retrieve.
729
+ # Format: `projects/{project}/locations/{location}/triggers/{trigger}`
745
730
  # @param project_id [::String]
746
731
  # Required. ID of the project that owns the trigger.
747
732
  # @param trigger_id [::String]
@@ -808,11 +793,14 @@ module Google
808
793
  # @param options [::Gapic::CallOptions, ::Hash]
809
794
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
810
795
  #
811
- # @overload list_build_triggers(project_id: nil, page_size: nil, page_token: nil)
796
+ # @overload list_build_triggers(parent: nil, project_id: nil, page_size: nil, page_token: nil)
812
797
  # Pass arguments to `list_build_triggers` via keyword arguments. Note that at
813
798
  # least one keyword argument is required. To specify no parameters, or to keep all
814
799
  # the default parameter values, pass an empty Hash as a request object (see above).
815
800
  #
801
+ # @param parent [::String]
802
+ # The parent of the collection of `Triggers`.
803
+ # Format: `projects/{project}/locations/{location}`
816
804
  # @param project_id [::String]
817
805
  # Required. ID of the project for which to list BuildTriggers.
818
806
  # @param page_size [::Integer]
@@ -881,11 +869,14 @@ module Google
881
869
  # @param options [::Gapic::CallOptions, ::Hash]
882
870
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
883
871
  #
884
- # @overload delete_build_trigger(project_id: nil, trigger_id: nil)
872
+ # @overload delete_build_trigger(name: nil, project_id: nil, trigger_id: nil)
885
873
  # Pass arguments to `delete_build_trigger` via keyword arguments. Note that at
886
874
  # least one keyword argument is required. To specify no parameters, or to keep all
887
875
  # the default parameter values, pass an empty Hash as a request object (see above).
888
876
  #
877
+ # @param name [::String]
878
+ # The name of the `Trigger` to delete.
879
+ # Format: `projects/{project}/locations/{location}/triggers/{trigger}`
889
880
  # @param project_id [::String]
890
881
  # Required. ID of the project that owns the trigger.
891
882
  # @param trigger_id [::String]
@@ -1023,11 +1014,14 @@ module Google
1023
1014
  # @param options [::Gapic::CallOptions, ::Hash]
1024
1015
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1025
1016
  #
1026
- # @overload run_build_trigger(project_id: nil, trigger_id: nil, source: nil)
1017
+ # @overload run_build_trigger(name: nil, project_id: nil, trigger_id: nil, source: nil)
1027
1018
  # Pass arguments to `run_build_trigger` via keyword arguments. Note that at
1028
1019
  # least one keyword argument is required. To specify no parameters, or to keep all
1029
1020
  # the default parameter values, pass an empty Hash as a request object (see above).
1030
1021
  #
1022
+ # @param name [::String]
1023
+ # The name of the `Trigger` to run.
1024
+ # Format: `projects/{project}/locations/{location}/triggers/{trigger}`
1031
1025
  # @param project_id [::String]
1032
1026
  # Required. ID of the project.
1033
1027
  # @param trigger_id [::String]
@@ -1096,11 +1090,14 @@ module Google
1096
1090
  # @param options [::Gapic::CallOptions, ::Hash]
1097
1091
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1098
1092
  #
1099
- # @overload receive_trigger_webhook(body: nil, project_id: nil, trigger: nil, secret: nil)
1093
+ # @overload receive_trigger_webhook(name: nil, body: nil, project_id: nil, trigger: nil, secret: nil)
1100
1094
  # Pass arguments to `receive_trigger_webhook` via keyword arguments. Note that at
1101
1095
  # least one keyword argument is required. To specify no parameters, or to keep all
1102
1096
  # the default parameter values, pass an empty Hash as a request object (see above).
1103
1097
  #
1098
+ # @param name [::String]
1099
+ # The name of the `ReceiveTriggerWebhook` to retrieve.
1100
+ # Format: `projects/{project}/locations/{location}/triggers/{trigger}`
1104
1101
  # @param body [::Google::Api::HttpBody, ::Hash]
1105
1102
  # HTTP request body.
1106
1103
  # @param project_id [::String]
@@ -1157,9 +1154,7 @@ module Google
1157
1154
  end
1158
1155
 
1159
1156
  ##
1160
- # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
1161
- #
1162
- # This API is experimental.
1157
+ # Creates a `WorkerPool`.
1163
1158
  #
1164
1159
  # @overload create_worker_pool(request, options = nil)
1165
1160
  # Pass arguments to `create_worker_pool` via a request object, either of type
@@ -1171,21 +1166,31 @@ module Google
1171
1166
  # @param options [::Gapic::CallOptions, ::Hash]
1172
1167
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1173
1168
  #
1174
- # @overload create_worker_pool(parent: nil, worker_pool: nil)
1169
+ # @overload create_worker_pool(parent: nil, worker_pool: nil, worker_pool_id: nil, validate_only: nil)
1175
1170
  # Pass arguments to `create_worker_pool` via keyword arguments. Note that at
1176
1171
  # least one keyword argument is required. To specify no parameters, or to keep all
1177
1172
  # the default parameter values, pass an empty Hash as a request object (see above).
1178
1173
  #
1179
1174
  # @param parent [::String]
1180
- # ID of the parent project.
1175
+ # Required. The parent resource where this worker pool will be created.
1176
+ # Format: `projects/{project}/locations/{location}`.
1181
1177
  # @param worker_pool [::Google::Cloud::Build::V1::WorkerPool, ::Hash]
1182
- # `WorkerPool` resource to create.
1178
+ # Required. `WorkerPool` resource to create.
1179
+ # @param worker_pool_id [::String]
1180
+ # Required. Immutable. The ID to use for the `WorkerPool`, which will become
1181
+ # the final component of the resource name.
1182
+ #
1183
+ # This value should be 1-63 characters, and valid characters
1184
+ # are /[a-z][0-9]-/.
1185
+ # @param validate_only [::Boolean]
1186
+ # If set, validate the request and preview the response, but do not actually
1187
+ # post it.
1183
1188
  #
1184
1189
  # @yield [response, operation] Access the result along with the RPC operation
1185
- # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
1190
+ # @yieldparam response [::Gapic::Operation]
1186
1191
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1187
1192
  #
1188
- # @return [::Google::Cloud::Build::V1::WorkerPool]
1193
+ # @return [::Gapic::Operation]
1189
1194
  #
1190
1195
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1191
1196
  #
@@ -1206,6 +1211,12 @@ module Google
1206
1211
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1207
1212
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1208
1213
 
1214
+ header_params = {
1215
+ "parent" => request.parent
1216
+ }
1217
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1218
+ metadata[:"x-goog-request-params"] ||= request_params_header
1219
+
1209
1220
  options.apply_defaults timeout: @config.rpcs.create_worker_pool.timeout,
1210
1221
  metadata: metadata,
1211
1222
  retry_policy: @config.rpcs.create_worker_pool.retry_policy
@@ -1213,6 +1224,7 @@ module Google
1213
1224
  retry_policy: @config.retry_policy
1214
1225
 
1215
1226
  @cloud_build_stub.call_rpc :create_worker_pool, request, options: options do |response, operation|
1227
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1216
1228
  yield response, operation if block_given?
1217
1229
  return response
1218
1230
  end
@@ -1221,9 +1233,7 @@ module Google
1221
1233
  end
1222
1234
 
1223
1235
  ##
1224
- # Returns information about a `WorkerPool`.
1225
- #
1226
- # This API is experimental.
1236
+ # Returns details of a `WorkerPool`.
1227
1237
  #
1228
1238
  # @overload get_worker_pool(request, options = nil)
1229
1239
  # Pass arguments to `get_worker_pool` via a request object, either of type
@@ -1241,8 +1251,8 @@ module Google
1241
1251
  # the default parameter values, pass an empty Hash as a request object (see above).
1242
1252
  #
1243
1253
  # @param name [::String]
1244
- # The field will contain name of the resource requested, for example:
1245
- # "projects/project-1/workerPools/workerpool-name"
1254
+ # Required. The name of the `WorkerPool` to retrieve.
1255
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1246
1256
  #
1247
1257
  # @yield [response, operation] Access the result along with the RPC operation
1248
1258
  # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
@@ -1269,6 +1279,12 @@ module Google
1269
1279
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1270
1280
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1271
1281
 
1282
+ header_params = {
1283
+ "name" => request.name
1284
+ }
1285
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1286
+ metadata[:"x-goog-request-params"] ||= request_params_header
1287
+
1272
1288
  options.apply_defaults timeout: @config.rpcs.get_worker_pool.timeout,
1273
1289
  metadata: metadata,
1274
1290
  retry_policy: @config.rpcs.get_worker_pool.retry_policy
@@ -1284,9 +1300,7 @@ module Google
1284
1300
  end
1285
1301
 
1286
1302
  ##
1287
- # Deletes a `WorkerPool` by its project ID and WorkerPool name.
1288
- #
1289
- # This API is experimental.
1303
+ # Deletes a `WorkerPool`.
1290
1304
  #
1291
1305
  # @overload delete_worker_pool(request, options = nil)
1292
1306
  # Pass arguments to `delete_worker_pool` via a request object, either of type
@@ -1298,20 +1312,30 @@ module Google
1298
1312
  # @param options [::Gapic::CallOptions, ::Hash]
1299
1313
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1300
1314
  #
1301
- # @overload delete_worker_pool(name: nil)
1315
+ # @overload delete_worker_pool(name: nil, etag: nil, allow_missing: nil, validate_only: nil)
1302
1316
  # Pass arguments to `delete_worker_pool` via keyword arguments. Note that at
1303
1317
  # least one keyword argument is required. To specify no parameters, or to keep all
1304
1318
  # the default parameter values, pass an empty Hash as a request object (see above).
1305
1319
  #
1306
1320
  # @param name [::String]
1307
- # The field will contain name of the resource requested, for example:
1308
- # "projects/project-1/workerPools/workerpool-name"
1321
+ # Required. The name of the `WorkerPool` to delete.
1322
+ # Format:
1323
+ # `projects/{project}/locations/{workerPool}/workerPools/{workerPool}`.
1324
+ # @param etag [::String]
1325
+ # Optional. If this is provided, it must match the server's etag on the
1326
+ # workerpool for the request to be processed.
1327
+ # @param allow_missing [::Boolean]
1328
+ # If set to true, and the `WorkerPool` is not found, the request will succeed
1329
+ # but no action will be taken on the server.
1330
+ # @param validate_only [::Boolean]
1331
+ # If set, validate the request and preview the response, but do not actually
1332
+ # post it.
1309
1333
  #
1310
1334
  # @yield [response, operation] Access the result along with the RPC operation
1311
- # @yieldparam response [::Google::Protobuf::Empty]
1335
+ # @yieldparam response [::Gapic::Operation]
1312
1336
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1313
1337
  #
1314
- # @return [::Google::Protobuf::Empty]
1338
+ # @return [::Gapic::Operation]
1315
1339
  #
1316
1340
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1317
1341
  #
@@ -1332,6 +1356,12 @@ module Google
1332
1356
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1333
1357
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1334
1358
 
1359
+ header_params = {
1360
+ "name" => request.name
1361
+ }
1362
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1363
+ metadata[:"x-goog-request-params"] ||= request_params_header
1364
+
1335
1365
  options.apply_defaults timeout: @config.rpcs.delete_worker_pool.timeout,
1336
1366
  metadata: metadata,
1337
1367
  retry_policy: @config.rpcs.delete_worker_pool.retry_policy
@@ -1339,6 +1369,7 @@ module Google
1339
1369
  retry_policy: @config.retry_policy
1340
1370
 
1341
1371
  @cloud_build_stub.call_rpc :delete_worker_pool, request, options: options do |response, operation|
1372
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1342
1373
  yield response, operation if block_given?
1343
1374
  return response
1344
1375
  end
@@ -1347,9 +1378,7 @@ module Google
1347
1378
  end
1348
1379
 
1349
1380
  ##
1350
- # Update a `WorkerPool`.
1351
- #
1352
- # This API is experimental.
1381
+ # Updates a `WorkerPool`.
1353
1382
  #
1354
1383
  # @overload update_worker_pool(request, options = nil)
1355
1384
  # Pass arguments to `update_worker_pool` via a request object, either of type
@@ -1361,22 +1390,27 @@ module Google
1361
1390
  # @param options [::Gapic::CallOptions, ::Hash]
1362
1391
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1363
1392
  #
1364
- # @overload update_worker_pool(name: nil, worker_pool: nil)
1393
+ # @overload update_worker_pool(worker_pool: nil, update_mask: nil, validate_only: nil)
1365
1394
  # Pass arguments to `update_worker_pool` via keyword arguments. Note that at
1366
1395
  # least one keyword argument is required. To specify no parameters, or to keep all
1367
1396
  # the default parameter values, pass an empty Hash as a request object (see above).
1368
1397
  #
1369
- # @param name [::String]
1370
- # The field will contain name of the resource requested, for example:
1371
- # "projects/project-1/workerPools/workerpool-name"
1372
1398
  # @param worker_pool [::Google::Cloud::Build::V1::WorkerPool, ::Hash]
1373
- # `WorkerPool` resource to update.
1399
+ # Required. The `WorkerPool` to update.
1400
+ #
1401
+ # The `name` field is used to identify the `WorkerPool` to update.
1402
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1403
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1404
+ # A mask specifying which fields in `worker_pool` to update.
1405
+ # @param validate_only [::Boolean]
1406
+ # If set, validate the request and preview the response, but do not actually
1407
+ # post it.
1374
1408
  #
1375
1409
  # @yield [response, operation] Access the result along with the RPC operation
1376
- # @yieldparam response [::Google::Cloud::Build::V1::WorkerPool]
1410
+ # @yieldparam response [::Gapic::Operation]
1377
1411
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1378
1412
  #
1379
- # @return [::Google::Cloud::Build::V1::WorkerPool]
1413
+ # @return [::Gapic::Operation]
1380
1414
  #
1381
1415
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1382
1416
  #
@@ -1397,6 +1431,12 @@ module Google
1397
1431
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1398
1432
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1399
1433
 
1434
+ header_params = {
1435
+ "worker_pool.name" => request.worker_pool.name
1436
+ }
1437
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1438
+ metadata[:"x-goog-request-params"] ||= request_params_header
1439
+
1400
1440
  options.apply_defaults timeout: @config.rpcs.update_worker_pool.timeout,
1401
1441
  metadata: metadata,
1402
1442
  retry_policy: @config.rpcs.update_worker_pool.retry_policy
@@ -1404,6 +1444,7 @@ module Google
1404
1444
  retry_policy: @config.retry_policy
1405
1445
 
1406
1446
  @cloud_build_stub.call_rpc :update_worker_pool, request, options: options do |response, operation|
1447
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1407
1448
  yield response, operation if block_given?
1408
1449
  return response
1409
1450
  end
@@ -1412,9 +1453,7 @@ module Google
1412
1453
  end
1413
1454
 
1414
1455
  ##
1415
- # List project's `WorkerPools`.
1416
- #
1417
- # This API is experimental.
1456
+ # Lists `WorkerPool`s.
1418
1457
  #
1419
1458
  # @overload list_worker_pools(request, options = nil)
1420
1459
  # Pass arguments to `list_worker_pools` via a request object, either of type
@@ -1426,19 +1465,26 @@ module Google
1426
1465
  # @param options [::Gapic::CallOptions, ::Hash]
1427
1466
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1428
1467
  #
1429
- # @overload list_worker_pools(parent: nil)
1468
+ # @overload list_worker_pools(parent: nil, page_size: nil, page_token: nil)
1430
1469
  # Pass arguments to `list_worker_pools` via keyword arguments. Note that at
1431
1470
  # least one keyword argument is required. To specify no parameters, or to keep all
1432
1471
  # the default parameter values, pass an empty Hash as a request object (see above).
1433
1472
  #
1434
1473
  # @param parent [::String]
1435
- # ID of the parent project.
1474
+ # Required. The parent of the collection of `WorkerPools`.
1475
+ # Format: `projects/{project}/locations/{location}`.
1476
+ # @param page_size [::Integer]
1477
+ # The maximum number of `WorkerPool`s to return. The service may return
1478
+ # fewer than this value. If omitted, the server will use a sensible default.
1479
+ # @param page_token [::String]
1480
+ # A page token, received from a previous `ListWorkerPools` call. Provide this
1481
+ # to retrieve the subsequent page.
1436
1482
  #
1437
1483
  # @yield [response, operation] Access the result along with the RPC operation
1438
- # @yieldparam response [::Google::Cloud::Build::V1::ListWorkerPoolsResponse]
1484
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Build::V1::WorkerPool>]
1439
1485
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
1440
1486
  #
1441
- # @return [::Google::Cloud::Build::V1::ListWorkerPoolsResponse]
1487
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Build::V1::WorkerPool>]
1442
1488
  #
1443
1489
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1444
1490
  #
@@ -1459,6 +1505,12 @@ module Google
1459
1505
  gapic_version: ::Google::Cloud::Build::V1::VERSION
1460
1506
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1461
1507
 
1508
+ header_params = {
1509
+ "parent" => request.parent
1510
+ }
1511
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1512
+ metadata[:"x-goog-request-params"] ||= request_params_header
1513
+
1462
1514
  options.apply_defaults timeout: @config.rpcs.list_worker_pools.timeout,
1463
1515
  metadata: metadata,
1464
1516
  retry_policy: @config.rpcs.list_worker_pools.retry_policy
@@ -1466,6 +1518,7 @@ module Google
1466
1518
  retry_policy: @config.retry_policy
1467
1519
 
1468
1520
  @cloud_build_stub.call_rpc :list_worker_pools, request, options: options do |response, operation|
1521
+ response = ::Gapic::PagedEnumerable.new @cloud_build_stub, :list_worker_pools, request, response, operation, options
1469
1522
  yield response, operation if block_given?
1470
1523
  return response
1471
1524
  end