google-cloud-build-v1 0.8.0 → 0.9.2

Sign up to get free protection for your applications and to get access to all the features.
@@ -169,7 +169,9 @@ module Google
169
169
  options.apply_defaults timeout: @config.rpcs.list_operations.timeout,
170
170
  metadata: metadata,
171
171
  retry_policy: @config.rpcs.list_operations.retry_policy
172
- options.apply_defaults metadata: @config.metadata,
172
+
173
+ options.apply_defaults timeout: @config.timeout,
174
+ metadata: @config.metadata,
173
175
  retry_policy: @config.retry_policy
174
176
 
175
177
  @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -239,7 +241,9 @@ module Google
239
241
  options.apply_defaults timeout: @config.rpcs.get_operation.timeout,
240
242
  metadata: metadata,
241
243
  retry_policy: @config.rpcs.get_operation.retry_policy
242
- options.apply_defaults metadata: @config.metadata,
244
+
245
+ options.apply_defaults timeout: @config.timeout,
246
+ metadata: @config.metadata,
243
247
  retry_policy: @config.retry_policy
244
248
 
245
249
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -309,7 +313,9 @@ module Google
309
313
  options.apply_defaults timeout: @config.rpcs.delete_operation.timeout,
310
314
  metadata: metadata,
311
315
  retry_policy: @config.rpcs.delete_operation.retry_policy
312
- options.apply_defaults metadata: @config.metadata,
316
+
317
+ options.apply_defaults timeout: @config.timeout,
318
+ metadata: @config.metadata,
313
319
  retry_policy: @config.retry_policy
314
320
 
315
321
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -384,7 +390,9 @@ module Google
384
390
  options.apply_defaults timeout: @config.rpcs.cancel_operation.timeout,
385
391
  metadata: metadata,
386
392
  retry_policy: @config.rpcs.cancel_operation.retry_policy
387
- options.apply_defaults metadata: @config.metadata,
393
+
394
+ options.apply_defaults timeout: @config.timeout,
395
+ metadata: @config.metadata,
388
396
  retry_policy: @config.retry_policy
389
397
 
390
398
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -396,9 +404,9 @@ module Google
396
404
  end
397
405
 
398
406
  ##
399
- # Waits for the specified long-running operation until it is done or reaches
400
- # at most a specified timeout, returning the latest state. If the operation
401
- # is already done, the latest state is immediately returned. If the timeout
407
+ # Waits until the specified long-running operation is done or reaches at most
408
+ # a specified timeout, returning the latest state. If the operation is
409
+ # already done, the latest state is immediately returned. If the timeout
402
410
  # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
403
411
  # timeout is used. If the server does not support this method, it returns
404
412
  # `google.rpc.Code.UNIMPLEMENTED`.
@@ -456,7 +464,9 @@ module Google
456
464
  options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
457
465
  metadata: metadata,
458
466
  retry_policy: @config.rpcs.wait_operation.retry_policy
459
- options.apply_defaults metadata: @config.metadata,
467
+
468
+ options.apply_defaults timeout: @config.timeout,
469
+ metadata: @config.metadata,
460
470
  retry_policy: @config.retry_policy
461
471
 
462
472
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +491,21 @@ module Google
481
491
  # Configuration can be applied globally to all clients, or to a single client
482
492
  # on construction.
483
493
  #
484
- # # Examples
485
- #
486
- # To modify the global config, setting the timeout for list_operations
487
- # to 20 seconds, and all remaining timeouts to 10 seconds:
488
- #
489
- # ::Google::Longrunning::Operations::Client.configure do |config|
490
- # config.timeout = 10.0
491
- # config.rpcs.list_operations.timeout = 20.0
492
- # end
493
- #
494
- # To apply the above configuration only to a new client:
495
- #
496
- # client = ::Google::Longrunning::Operations::Client.new do |config|
497
- # config.timeout = 10.0
498
- # config.rpcs.list_operations.timeout = 20.0
499
- # end
494
+ # @example
495
+ #
496
+ # # Modify the global config, setting the timeout for
497
+ # # list_operations to 20 seconds,
498
+ # # and all remaining timeouts to 10 seconds.
499
+ # ::Google::Longrunning::Operations::Client.configure do |config|
500
+ # config.timeout = 10.0
501
+ # config.rpcs.list_operations.timeout = 20.0
502
+ # end
503
+ #
504
+ # # Apply the above configuration only to a new client.
505
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
506
+ # config.timeout = 10.0
507
+ # config.rpcs.list_operations.timeout = 20.0
508
+ # end
500
509
  #
501
510
  # @!attribute [rw] endpoint
502
511
  # The hostname or hostname:port of the service endpoint.
@@ -144,6 +144,23 @@ module Google
144
144
  "projects/#{project}/locations/#{location}"
145
145
  end
146
146
 
147
+ ##
148
+ # Create a fully-qualified Network resource string.
149
+ #
150
+ # The resource will be in the following format:
151
+ #
152
+ # `projects/{project}/global/networks/{network}`
153
+ #
154
+ # @param project [String]
155
+ # @param network [String]
156
+ #
157
+ # @return [::String]
158
+ def network_path project:, network:
159
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
160
+
161
+ "projects/#{project}/global/networks/#{network}"
162
+ end
163
+
147
164
  ##
148
165
  # Create a fully-qualified Project resource string.
149
166
  #
@@ -228,6 +245,25 @@ module Google
228
245
  "projects/#{project}/topics/#{topic}"
229
246
  end
230
247
 
248
+ ##
249
+ # Create a fully-qualified WorkerPool resource string.
250
+ #
251
+ # The resource will be in the following format:
252
+ #
253
+ # `projects/{project}/locations/{location}/workerPools/{worker_pool}`
254
+ #
255
+ # @param project [String]
256
+ # @param location [String]
257
+ # @param worker_pool [String]
258
+ #
259
+ # @return [::String]
260
+ def worker_pool_path project:, location:, worker_pool:
261
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
262
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
263
+
264
+ "projects/#{project}/locations/#{location}/workerPools/#{worker_pool}"
265
+ end
266
+
231
267
  extend self
232
268
  end
233
269
  end
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Build
23
23
  module V1
24
- VERSION = "0.8.0"
24
+ VERSION = "0.9.2"
25
25
  end
26
26
  end
27
27
  end
@@ -119,6 +119,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
119
119
  optional :service_account, :string, 42
120
120
  optional :available_secrets, :message, 47, "google.devtools.cloudbuild.v1.Secrets"
121
121
  repeated :warnings, :message, 49, "google.devtools.cloudbuild.v1.Build.Warning"
122
+ optional :failure_info, :message, 51, "google.devtools.cloudbuild.v1.Build.FailureInfo"
122
123
  end
123
124
  add_message "google.devtools.cloudbuild.v1.Build.Warning" do
124
125
  optional :text, :string, 1
@@ -130,6 +131,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
130
131
  value :WARNING, 2
131
132
  value :ALERT, 3
132
133
  end
134
+ add_message "google.devtools.cloudbuild.v1.Build.FailureInfo" do
135
+ optional :type, :enum, 1, "google.devtools.cloudbuild.v1.Build.FailureInfo.FailureType"
136
+ optional :detail, :string, 2
137
+ end
138
+ add_enum "google.devtools.cloudbuild.v1.Build.FailureInfo.FailureType" do
139
+ value :FAILURE_TYPE_UNSPECIFIED, 0
140
+ value :PUSH_FAILED, 1
141
+ value :PUSH_IMAGE_NOT_FOUND, 2
142
+ value :PUSH_NOT_AUTHORIZED, 3
143
+ value :LOGGING_FAILURE, 4
144
+ value :USER_BUILD_STEP, 5
145
+ value :FETCH_SOURCE_FAILED, 6
146
+ end
133
147
  add_enum "google.devtools.cloudbuild.v1.Build.Status" do
134
148
  value :STATUS_UNKNOWN, 0
135
149
  value :QUEUED, 1
@@ -330,11 +344,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
330
344
  optional :dynamic_substitutions, :bool, 17
331
345
  optional :log_streaming_option, :enum, 5, "google.devtools.cloudbuild.v1.BuildOptions.LogStreamingOption"
332
346
  optional :worker_pool, :string, 7
347
+ optional :pool, :message, 19, "google.devtools.cloudbuild.v1.BuildOptions.PoolOption"
333
348
  optional :logging, :enum, 11, "google.devtools.cloudbuild.v1.BuildOptions.LoggingMode"
334
349
  repeated :env, :string, 12
335
350
  repeated :secret_env, :string, 13
336
351
  repeated :volumes, :message, 14, "google.devtools.cloudbuild.v1.Volume"
337
352
  end
353
+ add_message "google.devtools.cloudbuild.v1.BuildOptions.PoolOption" do
354
+ optional :name, :string, 1
355
+ end
338
356
  add_enum "google.devtools.cloudbuild.v1.BuildOptions.VerifyOption" do
339
357
  value :NOT_VERIFIED, 0
340
358
  value :VERIFIED, 1
@@ -373,61 +391,86 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
373
391
  add_message "google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse" do
374
392
  end
375
393
  add_message "google.devtools.cloudbuild.v1.WorkerPool" do
376
- optional :name, :string, 14
377
- optional :project_id, :string, 2
378
- optional :service_account_email, :string, 3
379
- optional :worker_count, :int64, 4
380
- optional :worker_config, :message, 16, "google.devtools.cloudbuild.v1.WorkerConfig"
381
- repeated :regions, :enum, 9, "google.devtools.cloudbuild.v1.WorkerPool.Region"
382
- optional :create_time, :message, 11, "google.protobuf.Timestamp"
383
- optional :update_time, :message, 17, "google.protobuf.Timestamp"
384
- optional :delete_time, :message, 12, "google.protobuf.Timestamp"
385
- optional :status, :enum, 13, "google.devtools.cloudbuild.v1.WorkerPool.Status"
386
- end
387
- add_enum "google.devtools.cloudbuild.v1.WorkerPool.Region" do
388
- value :REGION_UNSPECIFIED, 0
389
- value :US_CENTRAL1, 1
390
- value :US_WEST1, 2
391
- value :US_EAST1, 3
392
- value :US_EAST4, 4
393
- end
394
- add_enum "google.devtools.cloudbuild.v1.WorkerPool.Status" do
395
- value :STATUS_UNSPECIFIED, 0
394
+ optional :name, :string, 1
395
+ optional :display_name, :string, 2
396
+ optional :uid, :string, 3
397
+ map :annotations, :string, :string, 4
398
+ optional :create_time, :message, 5, "google.protobuf.Timestamp"
399
+ optional :update_time, :message, 6, "google.protobuf.Timestamp"
400
+ optional :delete_time, :message, 7, "google.protobuf.Timestamp"
401
+ optional :state, :enum, 8, "google.devtools.cloudbuild.v1.WorkerPool.State"
402
+ optional :etag, :string, 11
403
+ oneof :config do
404
+ optional :private_pool_v1_config, :message, 12, "google.devtools.cloudbuild.v1.PrivatePoolV1Config"
405
+ end
406
+ end
407
+ add_enum "google.devtools.cloudbuild.v1.WorkerPool.State" do
408
+ value :STATE_UNSPECIFIED, 0
396
409
  value :CREATING, 1
397
410
  value :RUNNING, 2
398
411
  value :DELETING, 3
399
412
  value :DELETED, 4
400
413
  end
401
- add_message "google.devtools.cloudbuild.v1.WorkerConfig" do
414
+ add_message "google.devtools.cloudbuild.v1.PrivatePoolV1Config" do
415
+ optional :worker_config, :message, 1, "google.devtools.cloudbuild.v1.PrivatePoolV1Config.WorkerConfig"
416
+ optional :network_config, :message, 2, "google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig"
417
+ end
418
+ add_message "google.devtools.cloudbuild.v1.PrivatePoolV1Config.WorkerConfig" do
402
419
  optional :machine_type, :string, 1
403
420
  optional :disk_size_gb, :int64, 2
404
- optional :network, :message, 3, "google.devtools.cloudbuild.v1.Network"
405
- optional :tag, :string, 4
406
421
  end
407
- add_message "google.devtools.cloudbuild.v1.Network" do
408
- optional :project_id, :string, 1
409
- optional :network, :string, 2
410
- optional :subnetwork, :string, 3
422
+ add_message "google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig" do
423
+ optional :peered_network, :string, 1
424
+ optional :egress_option, :enum, 2, "google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig.EgressOption"
425
+ end
426
+ add_enum "google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig.EgressOption" do
427
+ value :EGRESS_OPTION_UNSPECIFIED, 0
428
+ value :NO_PUBLIC_EGRESS, 1
429
+ value :PUBLIC_EGRESS, 2
411
430
  end
412
431
  add_message "google.devtools.cloudbuild.v1.CreateWorkerPoolRequest" do
413
432
  optional :parent, :string, 1
414
433
  optional :worker_pool, :message, 2, "google.devtools.cloudbuild.v1.WorkerPool"
434
+ optional :worker_pool_id, :string, 3
435
+ optional :validate_only, :bool, 4
415
436
  end
416
437
  add_message "google.devtools.cloudbuild.v1.GetWorkerPoolRequest" do
417
438
  optional :name, :string, 1
418
439
  end
419
440
  add_message "google.devtools.cloudbuild.v1.DeleteWorkerPoolRequest" do
420
441
  optional :name, :string, 1
442
+ optional :etag, :string, 2
443
+ optional :allow_missing, :bool, 3
444
+ optional :validate_only, :bool, 4
421
445
  end
422
446
  add_message "google.devtools.cloudbuild.v1.UpdateWorkerPoolRequest" do
423
- optional :name, :string, 2
424
- optional :worker_pool, :message, 3, "google.devtools.cloudbuild.v1.WorkerPool"
447
+ optional :worker_pool, :message, 1, "google.devtools.cloudbuild.v1.WorkerPool"
448
+ optional :update_mask, :message, 2, "google.protobuf.FieldMask"
449
+ optional :validate_only, :bool, 4
425
450
  end
426
451
  add_message "google.devtools.cloudbuild.v1.ListWorkerPoolsRequest" do
427
452
  optional :parent, :string, 1
453
+ optional :page_size, :int32, 2
454
+ optional :page_token, :string, 3
428
455
  end
429
456
  add_message "google.devtools.cloudbuild.v1.ListWorkerPoolsResponse" do
430
457
  repeated :worker_pools, :message, 1, "google.devtools.cloudbuild.v1.WorkerPool"
458
+ optional :next_page_token, :string, 2
459
+ end
460
+ add_message "google.devtools.cloudbuild.v1.CreateWorkerPoolOperationMetadata" do
461
+ optional :worker_pool, :string, 1
462
+ optional :create_time, :message, 2, "google.protobuf.Timestamp"
463
+ optional :complete_time, :message, 3, "google.protobuf.Timestamp"
464
+ end
465
+ add_message "google.devtools.cloudbuild.v1.UpdateWorkerPoolOperationMetadata" do
466
+ optional :worker_pool, :string, 1
467
+ optional :create_time, :message, 2, "google.protobuf.Timestamp"
468
+ optional :complete_time, :message, 3, "google.protobuf.Timestamp"
469
+ end
470
+ add_message "google.devtools.cloudbuild.v1.DeleteWorkerPoolOperationMetadata" do
471
+ optional :worker_pool, :string, 1
472
+ optional :create_time, :message, 2, "google.protobuf.Timestamp"
473
+ optional :complete_time, :message, 3, "google.protobuf.Timestamp"
431
474
  end
432
475
  end
433
476
  end
@@ -450,6 +493,8 @@ module Google
450
493
  Build = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build").msgclass
451
494
  Build::Warning = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build.Warning").msgclass
452
495
  Build::Warning::Priority = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build.Warning.Priority").enummodule
496
+ Build::FailureInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build.FailureInfo").msgclass
497
+ Build::FailureInfo::FailureType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build.FailureInfo.FailureType").enummodule
453
498
  Build::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Build.Status").enummodule
454
499
  Artifacts = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Artifacts").msgclass
455
500
  Artifacts::ArtifactObjects = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Artifacts.ArtifactObjects").msgclass
@@ -484,6 +529,7 @@ module Google
484
529
  DeleteBuildTriggerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.DeleteBuildTriggerRequest").msgclass
485
530
  UpdateBuildTriggerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.UpdateBuildTriggerRequest").msgclass
486
531
  BuildOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions").msgclass
532
+ BuildOptions::PoolOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.PoolOption").msgclass
487
533
  BuildOptions::VerifyOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.VerifyOption").enummodule
488
534
  BuildOptions::MachineType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.MachineType").enummodule
489
535
  BuildOptions::SubstitutionOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.SubstitutionOption").enummodule
@@ -492,16 +538,20 @@ module Google
492
538
  ReceiveTriggerWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookRequest").msgclass
493
539
  ReceiveTriggerWebhookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse").msgclass
494
540
  WorkerPool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool").msgclass
495
- WorkerPool::Region = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Region").enummodule
496
- WorkerPool::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Status").enummodule
497
- WorkerConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerConfig").msgclass
498
- Network = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Network").msgclass
541
+ WorkerPool::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.State").enummodule
542
+ PrivatePoolV1Config = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PrivatePoolV1Config").msgclass
543
+ PrivatePoolV1Config::WorkerConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PrivatePoolV1Config.WorkerConfig").msgclass
544
+ PrivatePoolV1Config::NetworkConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig").msgclass
545
+ PrivatePoolV1Config::NetworkConfig::EgressOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PrivatePoolV1Config.NetworkConfig.EgressOption").enummodule
499
546
  CreateWorkerPoolRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CreateWorkerPoolRequest").msgclass
500
547
  GetWorkerPoolRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.GetWorkerPoolRequest").msgclass
501
548
  DeleteWorkerPoolRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.DeleteWorkerPoolRequest").msgclass
502
549
  UpdateWorkerPoolRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.UpdateWorkerPoolRequest").msgclass
503
550
  ListWorkerPoolsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ListWorkerPoolsRequest").msgclass
504
551
  ListWorkerPoolsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ListWorkerPoolsResponse").msgclass
552
+ CreateWorkerPoolOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CreateWorkerPoolOperationMetadata").msgclass
553
+ UpdateWorkerPoolOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.UpdateWorkerPoolOperationMetadata").msgclass
554
+ DeleteWorkerPoolOperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.DeleteWorkerPoolOperationMetadata").msgclass
505
555
  end
506
556
  end
507
557
  end
@@ -34,7 +34,7 @@ module Google
34
34
  # determine the status of the build.
35
35
  class Service
36
36
 
37
- include ::GRPC::GenericService
37
+ include GRPC::GenericService
38
38
 
39
39
  self.marshal_class_method = :encode
40
40
  self.unmarshal_class_method = :decode
@@ -111,25 +111,15 @@ module Google
111
111
  # ReceiveTriggerWebhook [Experimental] is called when the API receives a
112
112
  # webhook request targeted at a specific trigger.
113
113
  rpc :ReceiveTriggerWebhook, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse
114
- # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
115
- #
116
- # This API is experimental.
117
- rpc :CreateWorkerPool, ::Google::Cloud::Build::V1::CreateWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
118
- # Returns information about a `WorkerPool`.
119
- #
120
- # This API is experimental.
114
+ # Creates a `WorkerPool`.
115
+ rpc :CreateWorkerPool, ::Google::Cloud::Build::V1::CreateWorkerPoolRequest, ::Google::Longrunning::Operation
116
+ # Returns details of a `WorkerPool`.
121
117
  rpc :GetWorkerPool, ::Google::Cloud::Build::V1::GetWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
122
- # Deletes a `WorkerPool` by its project ID and WorkerPool name.
123
- #
124
- # This API is experimental.
125
- rpc :DeleteWorkerPool, ::Google::Cloud::Build::V1::DeleteWorkerPoolRequest, ::Google::Protobuf::Empty
126
- # Update a `WorkerPool`.
127
- #
128
- # This API is experimental.
129
- rpc :UpdateWorkerPool, ::Google::Cloud::Build::V1::UpdateWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
130
- # List project's `WorkerPools`.
131
- #
132
- # This API is experimental.
118
+ # Deletes a `WorkerPool`.
119
+ rpc :DeleteWorkerPool, ::Google::Cloud::Build::V1::DeleteWorkerPoolRequest, ::Google::Longrunning::Operation
120
+ # Updates a `WorkerPool`.
121
+ rpc :UpdateWorkerPool, ::Google::Cloud::Build::V1::UpdateWorkerPoolRequest, ::Google::Longrunning::Operation
122
+ # Lists `WorkerPool`s.
133
123
  rpc :ListWorkerPools, ::Google::Cloud::Build::V1::ListWorkerPoolsRequest, ::Google::Cloud::Build::V1::ListWorkerPoolsResponse
134
124
  end
135
125
 
@@ -57,9 +57,15 @@ module Google
57
57
 
58
58
  # Denotes that a (repeated) field is an unordered list.
59
59
  # This indicates that the service may provide the elements of the list
60
- # in any arbitrary order, rather than the order the user originally
60
+ # in any arbitrary order, rather than the order the user originally
61
61
  # provided. Additionally, the list's order may or may not be stable.
62
62
  UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
63
69
  end
64
70
  end
65
71
  end
@@ -43,7 +43,8 @@ module Google
43
43
  #
44
44
  # service ResourceService {
45
45
  # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
46
- # rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty);
46
+ # rpc UpdateResource(google.api.HttpBody) returns
47
+ # (google.protobuf.Empty);
47
48
  # }
48
49
  #
49
50
  # Example with streaming methods:
@@ -59,10 +60,10 @@ module Google
59
60
  # handled, all other features will continue to work unchanged.
60
61
  # @!attribute [rw] content_type
61
62
  # @return [::String]
62
- # The HTTP Content-Type string representing the content type of the body.
63
+ # The HTTP Content-Type header value specifying the content type of the body.
63
64
  # @!attribute [rw] data
64
65
  # @return [::String]
65
- # HTTP body binary data.
66
+ # The HTTP request/response body as raw binary.
66
67
  # @!attribute [rw] extensions
67
68
  # @return [::Array<::Google::Protobuf::Any>]
68
69
  # Application specific response metadata. Must be set in the first response
@@ -471,9 +471,10 @@ module Google
471
471
  # Output only. Stores timing information for phases of the build. Valid keys
472
472
  # are:
473
473
  #
474
- # * BUILD: time to execute all build steps
474
+ # * BUILD: time to execute all build steps.
475
475
  # * PUSH: time to push all specified images.
476
476
  # * FETCHSOURCE: time to fetch source.
477
+ # * SETUPBUILD: time to set up build.
477
478
  #
478
479
  # If the build does not specify source or images,
479
480
  # these keys will not be included.
@@ -489,6 +490,9 @@ module Google
489
490
  # @return [::Array<::Google::Cloud::Build::V1::Build::Warning>]
490
491
  # Output only. Non-fatal problems encountered during the execution of the
491
492
  # build.
493
+ # @!attribute [r] failure_info
494
+ # @return [::Google::Cloud::Build::V1::Build::FailureInfo]
495
+ # Output only. Contains information about the build when status=FAILURE.
492
496
  class Build
493
497
  include ::Google::Protobuf::MessageExts
494
498
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -520,6 +524,43 @@ module Google
520
524
  end
521
525
  end
522
526
 
527
+ # A fatal problem encountered during the execution of the build.
528
+ # @!attribute [rw] type
529
+ # @return [::Google::Cloud::Build::V1::Build::FailureInfo::FailureType]
530
+ # The name of the failure.
531
+ # @!attribute [rw] detail
532
+ # @return [::String]
533
+ # Explains the failure issue in more detail using hard-coded text.
534
+ class FailureInfo
535
+ include ::Google::Protobuf::MessageExts
536
+ extend ::Google::Protobuf::MessageExts::ClassMethods
537
+
538
+ # The name of a fatal problem encountered during the execution of the
539
+ # build.
540
+ module FailureType
541
+ # Type unspecified
542
+ FAILURE_TYPE_UNSPECIFIED = 0
543
+
544
+ # Unable to push the image to the repository.
545
+ PUSH_FAILED = 1
546
+
547
+ # Final image not found.
548
+ PUSH_IMAGE_NOT_FOUND = 2
549
+
550
+ # Unauthorized push of the final image.
551
+ PUSH_NOT_AUTHORIZED = 3
552
+
553
+ # Backend logging failures. Should retry.
554
+ LOGGING_FAILURE = 4
555
+
556
+ # A build step has failed.
557
+ USER_BUILD_STEP = 5
558
+
559
+ # The source fetching has failed.
560
+ FETCH_SOURCE_FAILED = 6
561
+ end
562
+ end
563
+
523
564
  # @!attribute [rw] key
524
565
  # @return [::String]
525
566
  # @!attribute [rw] value
@@ -1290,10 +1331,14 @@ module Google
1290
1331
  # Storage.
1291
1332
  # @!attribute [rw] worker_pool
1292
1333
  # @return [::String]
1293
- # Option to specify a `WorkerPool` for the build.
1294
- # Format: projects/\\{project}/locations/\\{location}/workerPools/\\{workerPool}
1334
+ # This field deprecated; please use `pool.name` instead.
1335
+ # @!attribute [rw] pool
1336
+ # @return [::Google::Cloud::Build::V1::BuildOptions::PoolOption]
1337
+ # Optional. Specification for execution on a `WorkerPool`.
1295
1338
  #
1296
- # This field is in beta and is available only to restricted users.
1339
+ # See [running builds in a private
1340
+ # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
1341
+ # for more information.
1297
1342
  # @!attribute [rw] logging
1298
1343
  # @return [::Google::Cloud::Build::V1::BuildOptions::LoggingMode]
1299
1344
  # Option to specify the logging mode, which determines if and where build
@@ -1327,6 +1372,23 @@ module Google
1327
1372
  include ::Google::Protobuf::MessageExts
1328
1373
  extend ::Google::Protobuf::MessageExts::ClassMethods
1329
1374
 
1375
+ # Details about how a build should be executed on a `WorkerPool`.
1376
+ #
1377
+ # See [running builds in a private
1378
+ # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
1379
+ # for more information.
1380
+ # @!attribute [rw] name
1381
+ # @return [::String]
1382
+ # The `WorkerPool` resource to execute the build on.
1383
+ # You must have `cloudbuild.workerpools.use` on the project hosting the
1384
+ # WorkerPool.
1385
+ #
1386
+ # Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
1387
+ class PoolOption
1388
+ include ::Google::Protobuf::MessageExts
1389
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1390
+ end
1391
+
1330
1392
  # Specifies the manner in which the build should be verified, if at all.
1331
1393
  module VerifyOption
1332
1394
  # Not a verifiable build. (default)
@@ -1434,78 +1496,77 @@ module Google
1434
1496
  extend ::Google::Protobuf::MessageExts::ClassMethods
1435
1497
  end
1436
1498
 
1437
- # Configuration for a WorkerPool to run the builds.
1499
+ # Configuration for a `WorkerPool`.
1438
1500
  #
1439
- # Workers are machines that Cloud Build uses to run your builds. By default,
1440
- # all workers run in a project owned by Cloud Build. To have full control over
1441
- # the workers that execute your builds -- such as enabling them to access
1442
- # private resources on your private network -- you can request Cloud Build to
1443
- # run the workers in your own project by creating a custom workers pool.
1444
- # @!attribute [rw] name
1501
+ # Cloud Build owns and maintains a pool of workers for general use and have no
1502
+ # access to a project's private network. By default, builds submitted to
1503
+ # Cloud Build will use a worker from this pool.
1504
+ #
1505
+ # If your build needs access to resources on a private network,
1506
+ # create and use a `WorkerPool` to run your builds. Private `WorkerPool`s give
1507
+ # your builds access to any single VPC network that you
1508
+ # administer, including any on-prem resources connected to that VPC
1509
+ # network. For an overview of private pools, see
1510
+ # [Private pools
1511
+ # overview](https://cloud.google.com/build/docs/private-pools/private-pools-overview).
1512
+ # @!attribute [r] name
1445
1513
  # @return [::String]
1446
- # User-defined name of the `WorkerPool`.
1447
- # @!attribute [rw] project_id
1514
+ # Output only. The resource name of the `WorkerPool`, with format
1515
+ # `projects/{project}/locations/{location}/workerPools/{worker_pool}`.
1516
+ # The value of `{worker_pool}` is provided by `worker_pool_id` in
1517
+ # `CreateWorkerPool` request and the value of `{location}` is determined by
1518
+ # the endpoint accessed.
1519
+ # @!attribute [rw] display_name
1448
1520
  # @return [::String]
1449
- # The project ID of the GCP project for which the `WorkerPool` is created.
1450
- # @!attribute [rw] service_account_email
1521
+ # A user-specified, human-readable name for the `WorkerPool`. If provided,
1522
+ # this value must be 1-63 characters.
1523
+ # @!attribute [r] uid
1451
1524
  # @return [::String]
1452
- # Output only. The service account used to manage the `WorkerPool`. The
1453
- # service account must have the Compute Instance Admin (Beta) permission at
1454
- # the project level.
1455
- # @!attribute [rw] worker_count
1456
- # @return [::Integer]
1457
- # Total number of workers to be created across all requested regions.
1458
- # @!attribute [rw] worker_config
1459
- # @return [::Google::Cloud::Build::V1::WorkerConfig]
1460
- # Configuration to be used for a creating workers in the `WorkerPool`.
1461
- # @!attribute [rw] regions
1462
- # @return [::Array<::Google::Cloud::Build::V1::WorkerPool::Region>]
1463
- # List of regions to create the `WorkerPool`. Regions can't be empty.
1464
- # If Cloud Build adds a new GCP region in the future, the existing
1465
- # `WorkerPool` will not be enabled in the new region automatically;
1466
- # you must add the new region to the `regions` field to enable the
1467
- # `WorkerPool` in that region.
1468
- # @!attribute [rw] create_time
1525
+ # Output only. A unique identifier for the `WorkerPool`.
1526
+ # @!attribute [rw] annotations
1527
+ # @return [::Google::Protobuf::Map{::String => ::String}]
1528
+ # User specified annotations. See https://google.aip.dev/128#annotations
1529
+ # for more details such as format and size limitations.
1530
+ # @!attribute [r] create_time
1469
1531
  # @return [::Google::Protobuf::Timestamp]
1470
1532
  # Output only. Time at which the request to create the `WorkerPool` was
1471
1533
  # received.
1472
- # @!attribute [rw] update_time
1534
+ # @!attribute [r] update_time
1473
1535
  # @return [::Google::Protobuf::Timestamp]
1474
1536
  # Output only. Time at which the request to update the `WorkerPool` was
1475
1537
  # received.
1476
- # @!attribute [rw] delete_time
1538
+ # @!attribute [r] delete_time
1477
1539
  # @return [::Google::Protobuf::Timestamp]
1478
1540
  # Output only. Time at which the request to delete the `WorkerPool` was
1479
1541
  # received.
1480
- # @!attribute [rw] status
1481
- # @return [::Google::Cloud::Build::V1::WorkerPool::Status]
1482
- # Output only. WorkerPool Status.
1542
+ # @!attribute [r] state
1543
+ # @return [::Google::Cloud::Build::V1::WorkerPool::State]
1544
+ # Output only. `WorkerPool` state.
1545
+ # @!attribute [rw] private_pool_v1_config
1546
+ # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config]
1547
+ # Private Pool using a v1 configuration.
1548
+ # @!attribute [r] etag
1549
+ # @return [::String]
1550
+ # Output only. Checksum computed by the server. May be sent on update and
1551
+ # delete requests to ensure that the client has an up-to-date value before
1552
+ # proceeding.
1483
1553
  class WorkerPool
1484
1554
  include ::Google::Protobuf::MessageExts
1485
1555
  extend ::Google::Protobuf::MessageExts::ClassMethods
1486
1556
 
1487
- # Supported GCP regions to create the `WorkerPool`.
1488
- module Region
1489
- # no region
1490
- REGION_UNSPECIFIED = 0
1491
-
1492
- # us-central1 region
1493
- US_CENTRAL1 = 1
1494
-
1495
- # us-west1 region
1496
- US_WEST1 = 2
1497
-
1498
- # us-east1 region
1499
- US_EAST1 = 3
1500
-
1501
- # us-east4 region
1502
- US_EAST4 = 4
1557
+ # @!attribute [rw] key
1558
+ # @return [::String]
1559
+ # @!attribute [rw] value
1560
+ # @return [::String]
1561
+ class AnnotationsEntry
1562
+ include ::Google::Protobuf::MessageExts
1563
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1503
1564
  end
1504
1565
 
1505
- # `WorkerPool` status
1506
- module Status
1507
- # Status of the `WorkerPool` is unknown.
1508
- STATUS_UNSPECIFIED = 0
1566
+ # State of the `WorkerPool`.
1567
+ module State
1568
+ # State of the `WorkerPool` is unknown.
1569
+ STATE_UNSPECIFIED = 0
1509
1570
 
1510
1571
  # `WorkerPool` is being created.
1511
1572
  CREATING = 1
@@ -1521,71 +1582,90 @@ module Google
1521
1582
  end
1522
1583
  end
1523
1584
 
1524
- # WorkerConfig defines the configuration to be used for a creating workers in
1525
- # the pool.
1526
- # @!attribute [rw] machine_type
1527
- # @return [::String]
1528
- # Machine Type of the worker, such as n1-standard-1.
1529
- # See https://cloud.google.com/compute/docs/machine-types.
1530
- # If left blank, Cloud Build will use a standard unspecified machine to
1531
- # create the worker pool.
1532
- # `machine_type` is overridden if you specify a different machine type in
1533
- # `build_options`. In this case, the VM specified in the `build_options`
1534
- # will be created on demand at build time. For more information see
1535
- # https://cloud.google.com/cloud-build/docs/speeding-up-builds#using_custom_virtual_machine_sizes
1536
- # @!attribute [rw] disk_size_gb
1537
- # @return [::Integer]
1538
- # Size of the disk attached to the worker, in GB.
1539
- # See https://cloud.google.com/compute/docs/disks/
1540
- # If `0` is specified, Cloud Build will use a standard disk size.
1541
- # `disk_size` is overridden if you specify a different disk size in
1542
- # `build_options`. In this case, a VM with a disk size specified in the
1543
- # `build_options` will be created on demand at build time. For more
1544
- # information see
1545
- # https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions
1546
- # @!attribute [rw] network
1547
- # @return [::Google::Cloud::Build::V1::Network]
1548
- # The network definition used to create the worker.
1549
- # If this section is left empty, the workers will be created in
1550
- # WorkerPool.project_id on the default network.
1551
- # @!attribute [rw] tag
1552
- # @return [::String]
1553
- # The tag applied to the worker, and the same tag used by the firewall rule.
1554
- # It is used to identify the Cloud Build workers among other VMs.
1555
- # The default value for tag is `worker`.
1556
- class WorkerConfig
1585
+ # Configuration for a V1 `PrivatePool`.
1586
+ # @!attribute [rw] worker_config
1587
+ # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config::WorkerConfig]
1588
+ # Machine configuration for the workers in the pool.
1589
+ # @!attribute [rw] network_config
1590
+ # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config::NetworkConfig]
1591
+ # Network configuration for the pool.
1592
+ class PrivatePoolV1Config
1557
1593
  include ::Google::Protobuf::MessageExts
1558
1594
  extend ::Google::Protobuf::MessageExts::ClassMethods
1559
- end
1560
1595
 
1561
- # Network describes the GCP network used to create workers in.
1562
- # @!attribute [rw] project_id
1563
- # @return [::String]
1564
- # Project id containing the defined network and subnetwork. For a peered VPC,
1565
- # this will be the same as the project_id in which the workers are created.
1566
- # For a shared VPC, this will be the project sharing the network with the
1567
- # project_id project in which workers will be created. For custom workers
1568
- # with no VPC, this will be the same as project_id.
1569
- # @!attribute [rw] network
1570
- # @return [::String]
1571
- # Network on which the workers are created.
1572
- # "default" network is used if empty.
1573
- # @!attribute [rw] subnetwork
1574
- # @return [::String]
1575
- # Subnetwork on which the workers are created.
1576
- # "default" subnetwork is used if empty.
1577
- class Network
1578
- include ::Google::Protobuf::MessageExts
1579
- extend ::Google::Protobuf::MessageExts::ClassMethods
1596
+ # Defines the configuration to be used for creating workers in
1597
+ # the pool.
1598
+ # @!attribute [rw] machine_type
1599
+ # @return [::String]
1600
+ # Machine type of a worker, such as `e2-medium`.
1601
+ # See [Worker pool config
1602
+ # file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema).
1603
+ # If left blank, Cloud Build will use a sensible default.
1604
+ # @!attribute [rw] disk_size_gb
1605
+ # @return [::Integer]
1606
+ # Size of the disk attached to the worker, in GB.
1607
+ # See [Worker pool config
1608
+ # file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema).
1609
+ # Specify a value of up to 1000. If `0` is specified, Cloud Build will use
1610
+ # a standard disk size.
1611
+ class WorkerConfig
1612
+ include ::Google::Protobuf::MessageExts
1613
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1614
+ end
1615
+
1616
+ # Defines the network configuration for the pool.
1617
+ # @!attribute [rw] peered_network
1618
+ # @return [::String]
1619
+ # Required. Immutable. The network definition that the workers are peered
1620
+ # to. If this section is left empty, the workers will be peered to
1621
+ # `WorkerPool.project_id` on the service producer network. Must be in the
1622
+ # format `projects/{project}/global/networks/{network}`, where `{project}`
1623
+ # is a project number, such as `12345`, and `{network}` is the name of a
1624
+ # VPC network in the project. See
1625
+ # [Understanding network configuration
1626
+ # options](https://cloud.google.com/build/docs/private-pools/set-up-private-pool-environment)
1627
+ # @!attribute [rw] egress_option
1628
+ # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config::NetworkConfig::EgressOption]
1629
+ # Option to configure network egress for the workers.
1630
+ class NetworkConfig
1631
+ include ::Google::Protobuf::MessageExts
1632
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1633
+
1634
+ # Defines the egress option for the pool.
1635
+ module EgressOption
1636
+ # If set, defaults to PUBLIC_EGRESS.
1637
+ EGRESS_OPTION_UNSPECIFIED = 0
1638
+
1639
+ # If set, workers are created without any public address, which prevents
1640
+ # network egress to public IPs unless a network proxy is configured.
1641
+ NO_PUBLIC_EGRESS = 1
1642
+
1643
+ # If set, workers are created with a public address which allows for
1644
+ # public internet egress.
1645
+ PUBLIC_EGRESS = 2
1646
+ end
1647
+ end
1580
1648
  end
1581
1649
 
1582
1650
  # Request to create a new `WorkerPool`.
1583
1651
  # @!attribute [rw] parent
1584
1652
  # @return [::String]
1585
- # ID of the parent project.
1653
+ # Required. The parent resource where this worker pool will be created.
1654
+ # Format: `projects/{project}/locations/{location}`.
1586
1655
  # @!attribute [rw] worker_pool
1587
1656
  # @return [::Google::Cloud::Build::V1::WorkerPool]
1588
- # `WorkerPool` resource to create.
1657
+ # Required. `WorkerPool` resource to create.
1658
+ # @!attribute [rw] worker_pool_id
1659
+ # @return [::String]
1660
+ # Required. Immutable. The ID to use for the `WorkerPool`, which will become
1661
+ # the final component of the resource name.
1662
+ #
1663
+ # This value should be 1-63 characters, and valid characters
1664
+ # are /[a-z][0-9]-/.
1665
+ # @!attribute [rw] validate_only
1666
+ # @return [::Boolean]
1667
+ # If set, validate the request and preview the response, but do not actually
1668
+ # post it.
1589
1669
  class CreateWorkerPoolRequest
1590
1670
  include ::Google::Protobuf::MessageExts
1591
1671
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1594,8 +1674,8 @@ module Google
1594
1674
  # Request to get a `WorkerPool` with the specified name.
1595
1675
  # @!attribute [rw] name
1596
1676
  # @return [::String]
1597
- # The field will contain name of the resource requested, for example:
1598
- # "projects/project-1/workerPools/workerpool-name"
1677
+ # Required. The name of the `WorkerPool` to retrieve.
1678
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1599
1679
  class GetWorkerPoolRequest
1600
1680
  include ::Google::Protobuf::MessageExts
1601
1681
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1604,30 +1684,58 @@ module Google
1604
1684
  # Request to delete a `WorkerPool`.
1605
1685
  # @!attribute [rw] name
1606
1686
  # @return [::String]
1607
- # The field will contain name of the resource requested, for example:
1608
- # "projects/project-1/workerPools/workerpool-name"
1687
+ # Required. The name of the `WorkerPool` to delete.
1688
+ # Format:
1689
+ # `projects/{project}/locations/{workerPool}/workerPools/{workerPool}`.
1690
+ # @!attribute [rw] etag
1691
+ # @return [::String]
1692
+ # Optional. If this is provided, it must match the server's etag on the
1693
+ # workerpool for the request to be processed.
1694
+ # @!attribute [rw] allow_missing
1695
+ # @return [::Boolean]
1696
+ # If set to true, and the `WorkerPool` is not found, the request will succeed
1697
+ # but no action will be taken on the server.
1698
+ # @!attribute [rw] validate_only
1699
+ # @return [::Boolean]
1700
+ # If set, validate the request and preview the response, but do not actually
1701
+ # post it.
1609
1702
  class DeleteWorkerPoolRequest
1610
1703
  include ::Google::Protobuf::MessageExts
1611
1704
  extend ::Google::Protobuf::MessageExts::ClassMethods
1612
1705
  end
1613
1706
 
1614
1707
  # Request to update a `WorkerPool`.
1615
- # @!attribute [rw] name
1616
- # @return [::String]
1617
- # The field will contain name of the resource requested, for example:
1618
- # "projects/project-1/workerPools/workerpool-name"
1619
1708
  # @!attribute [rw] worker_pool
1620
1709
  # @return [::Google::Cloud::Build::V1::WorkerPool]
1621
- # `WorkerPool` resource to update.
1710
+ # Required. The `WorkerPool` to update.
1711
+ #
1712
+ # The `name` field is used to identify the `WorkerPool` to update.
1713
+ # Format: `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1714
+ # @!attribute [rw] update_mask
1715
+ # @return [::Google::Protobuf::FieldMask]
1716
+ # A mask specifying which fields in `worker_pool` to update.
1717
+ # @!attribute [rw] validate_only
1718
+ # @return [::Boolean]
1719
+ # If set, validate the request and preview the response, but do not actually
1720
+ # post it.
1622
1721
  class UpdateWorkerPoolRequest
1623
1722
  include ::Google::Protobuf::MessageExts
1624
1723
  extend ::Google::Protobuf::MessageExts::ClassMethods
1625
1724
  end
1626
1725
 
1627
- # Request to list `WorkerPools`.
1726
+ # Request to list `WorkerPool`s.
1628
1727
  # @!attribute [rw] parent
1629
1728
  # @return [::String]
1630
- # ID of the parent project.
1729
+ # Required. The parent of the collection of `WorkerPools`.
1730
+ # Format: `projects/{project}/locations/{location}`.
1731
+ # @!attribute [rw] page_size
1732
+ # @return [::Integer]
1733
+ # The maximum number of `WorkerPool`s to return. The service may return
1734
+ # fewer than this value. If omitted, the server will use a sensible default.
1735
+ # @!attribute [rw] page_token
1736
+ # @return [::String]
1737
+ # A page token, received from a previous `ListWorkerPools` call. Provide this
1738
+ # to retrieve the subsequent page.
1631
1739
  class ListWorkerPoolsRequest
1632
1740
  include ::Google::Protobuf::MessageExts
1633
1741
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1636,11 +1744,67 @@ module Google
1636
1744
  # Response containing existing `WorkerPools`.
1637
1745
  # @!attribute [rw] worker_pools
1638
1746
  # @return [::Array<::Google::Cloud::Build::V1::WorkerPool>]
1639
- # `WorkerPools` for the project.
1747
+ # `WorkerPools` for the specified project.
1748
+ # @!attribute [rw] next_page_token
1749
+ # @return [::String]
1750
+ # Continuation token used to page through large result sets. Provide this
1751
+ # value in a subsequent ListWorkerPoolsRequest to return the next page of
1752
+ # results.
1640
1753
  class ListWorkerPoolsResponse
1641
1754
  include ::Google::Protobuf::MessageExts
1642
1755
  extend ::Google::Protobuf::MessageExts::ClassMethods
1643
1756
  end
1757
+
1758
+ # Metadata for the `CreateWorkerPool` operation.
1759
+ # @!attribute [rw] worker_pool
1760
+ # @return [::String]
1761
+ # The resource name of the `WorkerPool` to create.
1762
+ # Format:
1763
+ # `projects/{project}/locations/{location}/workerPools/{worker_pool}`.
1764
+ # @!attribute [rw] create_time
1765
+ # @return [::Google::Protobuf::Timestamp]
1766
+ # Time the operation was created.
1767
+ # @!attribute [rw] complete_time
1768
+ # @return [::Google::Protobuf::Timestamp]
1769
+ # Time the operation was completed.
1770
+ class CreateWorkerPoolOperationMetadata
1771
+ include ::Google::Protobuf::MessageExts
1772
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1773
+ end
1774
+
1775
+ # Metadata for the `UpdateWorkerPool` operation.
1776
+ # @!attribute [rw] worker_pool
1777
+ # @return [::String]
1778
+ # The resource name of the `WorkerPool` being updated.
1779
+ # Format:
1780
+ # `projects/{project}/locations/{location}/workerPools/{worker_pool}`.
1781
+ # @!attribute [rw] create_time
1782
+ # @return [::Google::Protobuf::Timestamp]
1783
+ # Time the operation was created.
1784
+ # @!attribute [rw] complete_time
1785
+ # @return [::Google::Protobuf::Timestamp]
1786
+ # Time the operation was completed.
1787
+ class UpdateWorkerPoolOperationMetadata
1788
+ include ::Google::Protobuf::MessageExts
1789
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1790
+ end
1791
+
1792
+ # Metadata for the `DeleteWorkerPool` operation.
1793
+ # @!attribute [rw] worker_pool
1794
+ # @return [::String]
1795
+ # The resource name of the `WorkerPool` being deleted.
1796
+ # Format:
1797
+ # `projects/{project}/locations/{location}/workerPools/{worker_pool}`.
1798
+ # @!attribute [rw] create_time
1799
+ # @return [::Google::Protobuf::Timestamp]
1800
+ # Time the operation was created.
1801
+ # @!attribute [rw] complete_time
1802
+ # @return [::Google::Protobuf::Timestamp]
1803
+ # Time the operation was completed.
1804
+ class DeleteWorkerPoolOperationMetadata
1805
+ include ::Google::Protobuf::MessageExts
1806
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1807
+ end
1644
1808
  end
1645
1809
  end
1646
1810
  end