google-cloud-build-v1 0.23.0 → 0.24.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 5733cf8fcc884fdadf1d17a48ddd61a36720b53dbf01fbd9d951dad29aea5780
4
- data.tar.gz: c4e54b0188410f4c69b06d58b354da34dde085912fd3fb17c722022128e8a419
3
+ metadata.gz: e8c07fbd5653efcdbb0948955a0f71a0284a4f409360f6ef21549a70d4558640
4
+ data.tar.gz: daa41d65143df7629e48bde2136604b91e7269b5a2cbefe97695b2f6989ab1d4
5
5
  SHA512:
6
- metadata.gz: 3ce155c477e33b4a657033a7afff835e0c9784fef69535f8dc95bebfa3b1eab1ce4e4865f8cb92c7faa2dee10bb0f65d5ee7edb6286e8ccd8651bfc9daf7bd73
7
- data.tar.gz: 9f226bfa6a3a444c4746baf7f1b0ff671389af937d38c88a697a8a3b496c1e567b201f3420e8a84eb9865b7abd9e495039ed9cde1a9cd6aded65c85bc7df477d
6
+ metadata.gz: 5a8f31e0431f1f79da8dffc2f9c10b7c22efb799937aade4f25b3acb1a4974bbcca152f7b25b08b1f2cfd2b6ca4eefab705640d4b672fa464a292bfc9c12b18b
7
+ data.tar.gz: 5429167bd85f1f74a16489ab005e014b04b7ae94f52f1c11fb9e2e945ff06f15740c1e5306738b04810f1b3d676bef59dd4f14c96c6f193795efbe7cbb59e512
@@ -204,7 +204,8 @@ module Google
204
204
  credentials: credentials,
205
205
  endpoint: @config.endpoint,
206
206
  channel_args: @config.channel_args,
207
- interceptors: @config.interceptors
207
+ interceptors: @config.interceptors,
208
+ channel_pool_config: @config.channel_pool
208
209
  )
209
210
  end
210
211
 
@@ -2175,6 +2176,14 @@ module Google
2175
2176
  end
2176
2177
  end
2177
2178
 
2179
+ ##
2180
+ # Configuration for the channel pool
2181
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
2182
+ #
2183
+ def channel_pool
2184
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
2185
+ end
2186
+
2178
2187
  ##
2179
2188
  # Configuration RPC class for the CloudBuild API.
2180
2189
  #
@@ -93,7 +93,8 @@ module Google
93
93
  credentials: credentials,
94
94
  endpoint: @config.endpoint,
95
95
  channel_args: @config.channel_args,
96
- interceptors: @config.interceptors
96
+ interceptors: @config.interceptors,
97
+ channel_pool_config: @config.channel_pool
97
98
  )
98
99
 
99
100
  # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
701
702
  end
702
703
  end
703
704
 
705
+ ##
706
+ # Configuration for the channel pool
707
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
708
+ #
709
+ def channel_pool
710
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
711
+ end
712
+
704
713
  ##
705
714
  # Configuration RPC class for the Operations API.
706
715
  #
@@ -244,6 +244,29 @@ module Google
244
244
  # @return [::Gapic::Operation]
245
245
  #
246
246
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
247
+ #
248
+ # @example Basic example
249
+ # require "google/cloud/build/v1"
250
+ #
251
+ # # Create a client object. The client can be reused for multiple calls.
252
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
253
+ #
254
+ # # Create a request. To set request fields, pass in keyword arguments.
255
+ # request = Google::Cloud::Build::V1::CreateBuildRequest.new
256
+ #
257
+ # # Call the create_build method.
258
+ # result = client.create_build request
259
+ #
260
+ # # The returned object is of type Gapic::Operation. You can use it to
261
+ # # check the status of an operation, cancel it, or wait for results.
262
+ # # Here is how to wait for a response.
263
+ # result.wait_until_done! timeout: 60
264
+ # if result.response?
265
+ # p result.response
266
+ # else
267
+ # puts "No response received."
268
+ # end
269
+ #
247
270
  def create_build request, options = nil
248
271
  raise ::ArgumentError, "request must be provided" if request.nil?
249
272
 
@@ -315,6 +338,22 @@ module Google
315
338
  # @return [::Google::Cloud::Build::V1::Build]
316
339
  #
317
340
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
341
+ #
342
+ # @example Basic example
343
+ # require "google/cloud/build/v1"
344
+ #
345
+ # # Create a client object. The client can be reused for multiple calls.
346
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
347
+ #
348
+ # # Create a request. To set request fields, pass in keyword arguments.
349
+ # request = Google::Cloud::Build::V1::GetBuildRequest.new
350
+ #
351
+ # # Call the get_build method.
352
+ # result = client.get_build request
353
+ #
354
+ # # The returned object is of type Google::Cloud::Build::V1::Build.
355
+ # p result
356
+ #
318
357
  def get_build request, options = nil
319
358
  raise ::ArgumentError, "request must be provided" if request.nil?
320
359
 
@@ -397,6 +436,26 @@ module Google
397
436
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Build::V1::Build>]
398
437
  #
399
438
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
439
+ #
440
+ # @example Basic example
441
+ # require "google/cloud/build/v1"
442
+ #
443
+ # # Create a client object. The client can be reused for multiple calls.
444
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
445
+ #
446
+ # # Create a request. To set request fields, pass in keyword arguments.
447
+ # request = Google::Cloud::Build::V1::ListBuildsRequest.new
448
+ #
449
+ # # Call the list_builds method.
450
+ # result = client.list_builds request
451
+ #
452
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
453
+ # # over elements, and API calls will be issued to fetch pages as needed.
454
+ # result.each do |item|
455
+ # # Each element is of type ::Google::Cloud::Build::V1::Build.
456
+ # p item
457
+ # end
458
+ #
400
459
  def list_builds request, options = nil
401
460
  raise ::ArgumentError, "request must be provided" if request.nil?
402
461
 
@@ -465,6 +524,22 @@ module Google
465
524
  # @return [::Google::Cloud::Build::V1::Build]
466
525
  #
467
526
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
527
+ #
528
+ # @example Basic example
529
+ # require "google/cloud/build/v1"
530
+ #
531
+ # # Create a client object. The client can be reused for multiple calls.
532
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
533
+ #
534
+ # # Create a request. To set request fields, pass in keyword arguments.
535
+ # request = Google::Cloud::Build::V1::CancelBuildRequest.new
536
+ #
537
+ # # Call the cancel_build method.
538
+ # result = client.cancel_build request
539
+ #
540
+ # # The returned object is of type Google::Cloud::Build::V1::Build.
541
+ # p result
542
+ #
468
543
  def cancel_build request, options = nil
469
544
  raise ::ArgumentError, "request must be provided" if request.nil?
470
545
 
@@ -558,6 +633,29 @@ module Google
558
633
  # @return [::Gapic::Operation]
559
634
  #
560
635
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
636
+ #
637
+ # @example Basic example
638
+ # require "google/cloud/build/v1"
639
+ #
640
+ # # Create a client object. The client can be reused for multiple calls.
641
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
642
+ #
643
+ # # Create a request. To set request fields, pass in keyword arguments.
644
+ # request = Google::Cloud::Build::V1::RetryBuildRequest.new
645
+ #
646
+ # # Call the retry_build method.
647
+ # result = client.retry_build request
648
+ #
649
+ # # The returned object is of type Gapic::Operation. You can use it to
650
+ # # check the status of an operation, cancel it, or wait for results.
651
+ # # Here is how to wait for a response.
652
+ # result.wait_until_done! timeout: 60
653
+ # if result.response?
654
+ # p result.response
655
+ # else
656
+ # puts "No response received."
657
+ # end
658
+ #
561
659
  def retry_build request, options = nil
562
660
  raise ::ArgumentError, "request must be provided" if request.nil?
563
661
 
@@ -629,6 +727,29 @@ module Google
629
727
  # @return [::Gapic::Operation]
630
728
  #
631
729
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
730
+ #
731
+ # @example Basic example
732
+ # require "google/cloud/build/v1"
733
+ #
734
+ # # Create a client object. The client can be reused for multiple calls.
735
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
736
+ #
737
+ # # Create a request. To set request fields, pass in keyword arguments.
738
+ # request = Google::Cloud::Build::V1::ApproveBuildRequest.new
739
+ #
740
+ # # Call the approve_build method.
741
+ # result = client.approve_build request
742
+ #
743
+ # # The returned object is of type Gapic::Operation. You can use it to
744
+ # # check the status of an operation, cancel it, or wait for results.
745
+ # # Here is how to wait for a response.
746
+ # result.wait_until_done! timeout: 60
747
+ # if result.response?
748
+ # p result.response
749
+ # else
750
+ # puts "No response received."
751
+ # end
752
+ #
632
753
  def approve_build request, options = nil
633
754
  raise ::ArgumentError, "request must be provided" if request.nil?
634
755
 
@@ -699,6 +820,22 @@ module Google
699
820
  # @return [::Google::Cloud::Build::V1::BuildTrigger]
700
821
  #
701
822
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
823
+ #
824
+ # @example Basic example
825
+ # require "google/cloud/build/v1"
826
+ #
827
+ # # Create a client object. The client can be reused for multiple calls.
828
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
829
+ #
830
+ # # Create a request. To set request fields, pass in keyword arguments.
831
+ # request = Google::Cloud::Build::V1::CreateBuildTriggerRequest.new
832
+ #
833
+ # # Call the create_build_trigger method.
834
+ # result = client.create_build_trigger request
835
+ #
836
+ # # The returned object is of type Google::Cloud::Build::V1::BuildTrigger.
837
+ # p result
838
+ #
702
839
  def create_build_trigger request, options = nil
703
840
  raise ::ArgumentError, "request must be provided" if request.nil?
704
841
 
@@ -768,6 +905,22 @@ module Google
768
905
  # @return [::Google::Cloud::Build::V1::BuildTrigger]
769
906
  #
770
907
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
908
+ #
909
+ # @example Basic example
910
+ # require "google/cloud/build/v1"
911
+ #
912
+ # # Create a client object. The client can be reused for multiple calls.
913
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
914
+ #
915
+ # # Create a request. To set request fields, pass in keyword arguments.
916
+ # request = Google::Cloud::Build::V1::GetBuildTriggerRequest.new
917
+ #
918
+ # # Call the get_build_trigger method.
919
+ # result = client.get_build_trigger request
920
+ #
921
+ # # The returned object is of type Google::Cloud::Build::V1::BuildTrigger.
922
+ # p result
923
+ #
771
924
  def get_build_trigger request, options = nil
772
925
  raise ::ArgumentError, "request must be provided" if request.nil?
773
926
 
@@ -839,6 +992,26 @@ module Google
839
992
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Build::V1::BuildTrigger>]
840
993
  #
841
994
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
995
+ #
996
+ # @example Basic example
997
+ # require "google/cloud/build/v1"
998
+ #
999
+ # # Create a client object. The client can be reused for multiple calls.
1000
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1001
+ #
1002
+ # # Create a request. To set request fields, pass in keyword arguments.
1003
+ # request = Google::Cloud::Build::V1::ListBuildTriggersRequest.new
1004
+ #
1005
+ # # Call the list_build_triggers method.
1006
+ # result = client.list_build_triggers request
1007
+ #
1008
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1009
+ # # over elements, and API calls will be issued to fetch pages as needed.
1010
+ # result.each do |item|
1011
+ # # Each element is of type ::Google::Cloud::Build::V1::BuildTrigger.
1012
+ # p item
1013
+ # end
1014
+ #
842
1015
  def list_build_triggers request, options = nil
843
1016
  raise ::ArgumentError, "request must be provided" if request.nil?
844
1017
 
@@ -909,6 +1082,22 @@ module Google
909
1082
  # @return [::Google::Protobuf::Empty]
910
1083
  #
911
1084
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1085
+ #
1086
+ # @example Basic example
1087
+ # require "google/cloud/build/v1"
1088
+ #
1089
+ # # Create a client object. The client can be reused for multiple calls.
1090
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1091
+ #
1092
+ # # Create a request. To set request fields, pass in keyword arguments.
1093
+ # request = Google::Cloud::Build::V1::DeleteBuildTriggerRequest.new
1094
+ #
1095
+ # # Call the delete_build_trigger method.
1096
+ # result = client.delete_build_trigger request
1097
+ #
1098
+ # # The returned object is of type Google::Protobuf::Empty.
1099
+ # p result
1100
+ #
912
1101
  def delete_build_trigger request, options = nil
913
1102
  raise ::ArgumentError, "request must be provided" if request.nil?
914
1103
 
@@ -981,6 +1170,22 @@ module Google
981
1170
  # @return [::Google::Cloud::Build::V1::BuildTrigger]
982
1171
  #
983
1172
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1173
+ #
1174
+ # @example Basic example
1175
+ # require "google/cloud/build/v1"
1176
+ #
1177
+ # # Create a client object. The client can be reused for multiple calls.
1178
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1179
+ #
1180
+ # # Create a request. To set request fields, pass in keyword arguments.
1181
+ # request = Google::Cloud::Build::V1::UpdateBuildTriggerRequest.new
1182
+ #
1183
+ # # Call the update_build_trigger method.
1184
+ # result = client.update_build_trigger request
1185
+ #
1186
+ # # The returned object is of type Google::Cloud::Build::V1::BuildTrigger.
1187
+ # p result
1188
+ #
984
1189
  def update_build_trigger request, options = nil
985
1190
  raise ::ArgumentError, "request must be provided" if request.nil?
986
1191
 
@@ -1057,6 +1262,29 @@ module Google
1057
1262
  # @return [::Gapic::Operation]
1058
1263
  #
1059
1264
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1265
+ #
1266
+ # @example Basic example
1267
+ # require "google/cloud/build/v1"
1268
+ #
1269
+ # # Create a client object. The client can be reused for multiple calls.
1270
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1271
+ #
1272
+ # # Create a request. To set request fields, pass in keyword arguments.
1273
+ # request = Google::Cloud::Build::V1::RunBuildTriggerRequest.new
1274
+ #
1275
+ # # Call the run_build_trigger method.
1276
+ # result = client.run_build_trigger request
1277
+ #
1278
+ # # The returned object is of type Gapic::Operation. You can use it to
1279
+ # # check the status of an operation, cancel it, or wait for results.
1280
+ # # Here is how to wait for a response.
1281
+ # result.wait_until_done! timeout: 60
1282
+ # if result.response?
1283
+ # p result.response
1284
+ # else
1285
+ # puts "No response received."
1286
+ # end
1287
+ #
1060
1288
  def run_build_trigger request, options = nil
1061
1289
  raise ::ArgumentError, "request must be provided" if request.nil?
1062
1290
 
@@ -1130,6 +1358,22 @@ module Google
1130
1358
  # @return [::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse]
1131
1359
  #
1132
1360
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1361
+ #
1362
+ # @example Basic example
1363
+ # require "google/cloud/build/v1"
1364
+ #
1365
+ # # Create a client object. The client can be reused for multiple calls.
1366
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1367
+ #
1368
+ # # Create a request. To set request fields, pass in keyword arguments.
1369
+ # request = Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest.new
1370
+ #
1371
+ # # Call the receive_trigger_webhook method.
1372
+ # result = client.receive_trigger_webhook request
1373
+ #
1374
+ # # The returned object is of type Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse.
1375
+ # p result
1376
+ #
1133
1377
  def receive_trigger_webhook request, options = nil
1134
1378
  raise ::ArgumentError, "request must be provided" if request.nil?
1135
1379
 
@@ -1204,6 +1448,29 @@ module Google
1204
1448
  # @return [::Gapic::Operation]
1205
1449
  #
1206
1450
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1451
+ #
1452
+ # @example Basic example
1453
+ # require "google/cloud/build/v1"
1454
+ #
1455
+ # # Create a client object. The client can be reused for multiple calls.
1456
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1457
+ #
1458
+ # # Create a request. To set request fields, pass in keyword arguments.
1459
+ # request = Google::Cloud::Build::V1::CreateWorkerPoolRequest.new
1460
+ #
1461
+ # # Call the create_worker_pool method.
1462
+ # result = client.create_worker_pool request
1463
+ #
1464
+ # # The returned object is of type Gapic::Operation. You can use it to
1465
+ # # check the status of an operation, cancel it, or wait for results.
1466
+ # # Here is how to wait for a response.
1467
+ # result.wait_until_done! timeout: 60
1468
+ # if result.response?
1469
+ # p result.response
1470
+ # else
1471
+ # puts "No response received."
1472
+ # end
1473
+ #
1207
1474
  def create_worker_pool request, options = nil
1208
1475
  raise ::ArgumentError, "request must be provided" if request.nil?
1209
1476
 
@@ -1268,6 +1535,22 @@ module Google
1268
1535
  # @return [::Google::Cloud::Build::V1::WorkerPool]
1269
1536
  #
1270
1537
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1538
+ #
1539
+ # @example Basic example
1540
+ # require "google/cloud/build/v1"
1541
+ #
1542
+ # # Create a client object. The client can be reused for multiple calls.
1543
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1544
+ #
1545
+ # # Create a request. To set request fields, pass in keyword arguments.
1546
+ # request = Google::Cloud::Build::V1::GetWorkerPoolRequest.new
1547
+ #
1548
+ # # Call the get_worker_pool method.
1549
+ # result = client.get_worker_pool request
1550
+ #
1551
+ # # The returned object is of type Google::Cloud::Build::V1::WorkerPool.
1552
+ # p result
1553
+ #
1271
1554
  def get_worker_pool request, options = nil
1272
1555
  raise ::ArgumentError, "request must be provided" if request.nil?
1273
1556
 
@@ -1341,6 +1624,29 @@ module Google
1341
1624
  # @return [::Gapic::Operation]
1342
1625
  #
1343
1626
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1627
+ #
1628
+ # @example Basic example
1629
+ # require "google/cloud/build/v1"
1630
+ #
1631
+ # # Create a client object. The client can be reused for multiple calls.
1632
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1633
+ #
1634
+ # # Create a request. To set request fields, pass in keyword arguments.
1635
+ # request = Google::Cloud::Build::V1::DeleteWorkerPoolRequest.new
1636
+ #
1637
+ # # Call the delete_worker_pool method.
1638
+ # result = client.delete_worker_pool request
1639
+ #
1640
+ # # The returned object is of type Gapic::Operation. You can use it to
1641
+ # # check the status of an operation, cancel it, or wait for results.
1642
+ # # Here is how to wait for a response.
1643
+ # result.wait_until_done! timeout: 60
1644
+ # if result.response?
1645
+ # p result.response
1646
+ # else
1647
+ # puts "No response received."
1648
+ # end
1649
+ #
1344
1650
  def delete_worker_pool request, options = nil
1345
1651
  raise ::ArgumentError, "request must be provided" if request.nil?
1346
1652
 
@@ -1412,6 +1718,29 @@ module Google
1412
1718
  # @return [::Gapic::Operation]
1413
1719
  #
1414
1720
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1721
+ #
1722
+ # @example Basic example
1723
+ # require "google/cloud/build/v1"
1724
+ #
1725
+ # # Create a client object. The client can be reused for multiple calls.
1726
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1727
+ #
1728
+ # # Create a request. To set request fields, pass in keyword arguments.
1729
+ # request = Google::Cloud::Build::V1::UpdateWorkerPoolRequest.new
1730
+ #
1731
+ # # Call the update_worker_pool method.
1732
+ # result = client.update_worker_pool request
1733
+ #
1734
+ # # The returned object is of type Gapic::Operation. You can use it to
1735
+ # # check the status of an operation, cancel it, or wait for results.
1736
+ # # Here is how to wait for a response.
1737
+ # result.wait_until_done! timeout: 60
1738
+ # if result.response?
1739
+ # p result.response
1740
+ # else
1741
+ # puts "No response received."
1742
+ # end
1743
+ #
1415
1744
  def update_worker_pool request, options = nil
1416
1745
  raise ::ArgumentError, "request must be provided" if request.nil?
1417
1746
 
@@ -1482,6 +1811,26 @@ module Google
1482
1811
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Build::V1::WorkerPool>]
1483
1812
  #
1484
1813
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1814
+ #
1815
+ # @example Basic example
1816
+ # require "google/cloud/build/v1"
1817
+ #
1818
+ # # Create a client object. The client can be reused for multiple calls.
1819
+ # client = Google::Cloud::Build::V1::CloudBuild::Rest::Client.new
1820
+ #
1821
+ # # Create a request. To set request fields, pass in keyword arguments.
1822
+ # request = Google::Cloud::Build::V1::ListWorkerPoolsRequest.new
1823
+ #
1824
+ # # Call the list_worker_pools method.
1825
+ # result = client.list_worker_pools request
1826
+ #
1827
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1828
+ # # over elements, and API calls will be issued to fetch pages as needed.
1829
+ # result.each do |item|
1830
+ # # Each element is of type ::Google::Cloud::Build::V1::WorkerPool.
1831
+ # p item
1832
+ # end
1833
+ #
1485
1834
  def list_worker_pools request, options = nil
1486
1835
  raise ::ArgumentError, "request must be provided" if request.nil?
1487
1836
 
@@ -136,6 +136,26 @@ module Google
136
136
  # @return [::Gapic::Operation]
137
137
  #
138
138
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
139
+ #
140
+ # @example Basic example
141
+ # require "google/longrunning"
142
+ #
143
+ # # Create a client object. The client can be reused for multiple calls.
144
+ # client = Google::Longrunning::Operations::Rest::Client.new
145
+ #
146
+ # # Create a request. To set request fields, pass in keyword arguments.
147
+ # request = Google::Longrunning::ListOperationsRequest.new
148
+ #
149
+ # # Call the list_operations method.
150
+ # result = client.list_operations request
151
+ #
152
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
153
+ # # over elements, and API calls will be issued to fetch pages as needed.
154
+ # result.each do |item|
155
+ # # Each element is of type ::Google::Longrunning::Operation.
156
+ # p item
157
+ # end
158
+ #
139
159
  def list_operations request, options = nil
140
160
  raise ::ArgumentError, "request must be provided" if request.nil?
141
161
 
@@ -201,6 +221,29 @@ module Google
201
221
  # @return [::Gapic::Operation]
202
222
  #
203
223
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
224
+ #
225
+ # @example Basic example
226
+ # require "google/longrunning"
227
+ #
228
+ # # Create a client object. The client can be reused for multiple calls.
229
+ # client = Google::Longrunning::Operations::Rest::Client.new
230
+ #
231
+ # # Create a request. To set request fields, pass in keyword arguments.
232
+ # request = Google::Longrunning::GetOperationRequest.new
233
+ #
234
+ # # Call the get_operation method.
235
+ # result = client.get_operation request
236
+ #
237
+ # # The returned object is of type Gapic::Operation. You can use it to
238
+ # # check the status of an operation, cancel it, or wait for results.
239
+ # # Here is how to wait for a response.
240
+ # result.wait_until_done! timeout: 60
241
+ # if result.response?
242
+ # p result.response
243
+ # else
244
+ # puts "No response received."
245
+ # end
246
+ #
204
247
  def get_operation request, options = nil
205
248
  raise ::ArgumentError, "request must be provided" if request.nil?
206
249
 
@@ -267,6 +310,22 @@ module Google
267
310
  # @return [::Google::Protobuf::Empty]
268
311
  #
269
312
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
313
+ #
314
+ # @example Basic example
315
+ # require "google/longrunning"
316
+ #
317
+ # # Create a client object. The client can be reused for multiple calls.
318
+ # client = Google::Longrunning::Operations::Rest::Client.new
319
+ #
320
+ # # Create a request. To set request fields, pass in keyword arguments.
321
+ # request = Google::Longrunning::DeleteOperationRequest.new
322
+ #
323
+ # # Call the delete_operation method.
324
+ # result = client.delete_operation request
325
+ #
326
+ # # The returned object is of type Google::Protobuf::Empty.
327
+ # p result
328
+ #
270
329
  def delete_operation request, options = nil
271
330
  raise ::ArgumentError, "request must be provided" if request.nil?
272
331
 
@@ -338,6 +397,22 @@ module Google
338
397
  # @return [::Google::Protobuf::Empty]
339
398
  #
340
399
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
400
+ #
401
+ # @example Basic example
402
+ # require "google/longrunning"
403
+ #
404
+ # # Create a client object. The client can be reused for multiple calls.
405
+ # client = Google::Longrunning::Operations::Rest::Client.new
406
+ #
407
+ # # Create a request. To set request fields, pass in keyword arguments.
408
+ # request = Google::Longrunning::CancelOperationRequest.new
409
+ #
410
+ # # Call the cancel_operation method.
411
+ # result = client.cancel_operation request
412
+ #
413
+ # # The returned object is of type Google::Protobuf::Empty.
414
+ # p result
415
+ #
341
416
  def cancel_operation request, options = nil
342
417
  raise ::ArgumentError, "request must be provided" if request.nil?
343
418
 
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Build
23
23
  module V1
24
- VERSION = "0.23.0"
24
+ VERSION = "0.24.0"
25
25
  end
26
26
  end
27
27
  end
@@ -66,6 +66,20 @@ module Google
66
66
  # a non-empty value will be returned. The user will not be aware of what
67
67
  # non-empty value to expect.
68
68
  NON_EMPTY_DEFAULT = 7
69
+
70
+ # Denotes that the field in a resource (a message annotated with
71
+ # google.api.resource) is used in the resource name to uniquely identify the
72
+ # resource. For AIP-compliant APIs, this should only be applied to the
73
+ # `name` field on the resource.
74
+ #
75
+ # This behavior should not be applied to references to other resources within
76
+ # the message.
77
+ #
78
+ # The identifier field of resources often have different field behavior
79
+ # depending on the request it is embedded in (e.g. for Create methods name
80
+ # is optional and unused, while for Update methods it is required). Instead
81
+ # of method-specific annotations, only `IDENTIFIER` is required.
82
+ IDENTIFIER = 8
69
83
  end
70
84
  end
71
85
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-build-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.23.0
4
+ version: 0.24.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-08-03 00:00:00.000000000 Z
11
+ date: 2023-09-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.19.1
19
+ version: 0.20.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.19.1
29
+ version: 0.20.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -220,7 +220,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
220
220
  - !ruby/object:Gem::Version
221
221
  version: '0'
222
222
  requirements: []
223
- rubygems_version: 3.4.2
223
+ rubygems_version: 3.4.19
224
224
  signing_key:
225
225
  specification_version: 4
226
226
  summary: Creates and manages builds on Google Cloud Platform.