google-cloud-build-v1 0.8.0 → 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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