google-cloud-channel-v1 1.1.0 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -203,8 +203,19 @@ module Google
203
203
  endpoint: @config.endpoint,
204
204
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
205
205
  universe_domain: @config.universe_domain,
206
- credentials: credentials
206
+ credentials: credentials,
207
+ logger: @config.logger
207
208
  )
209
+
210
+ @cloud_channel_service_stub.logger(stub: true)&.info do |entry|
211
+ entry.set_system_name
212
+ entry.set_service
213
+ entry.message = "Created client for #{entry.service}"
214
+ entry.set_credentials_fields credentials
215
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
216
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
217
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
218
+ end
208
219
  end
209
220
 
210
221
  ##
@@ -214,6 +225,15 @@ module Google
214
225
  #
215
226
  attr_reader :operations_client
216
227
 
228
+ ##
229
+ # The logger used for request/response debug logging.
230
+ #
231
+ # @return [Logger]
232
+ #
233
+ def logger
234
+ @cloud_channel_service_stub.logger
235
+ end
236
+
217
237
  # Service calls
218
238
 
219
239
  ##
@@ -321,7 +341,7 @@ module Google
321
341
  @cloud_channel_service_stub.list_customers request, options do |result, operation|
322
342
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_customers, "customers", request, result, options
323
343
  yield result, operation if block_given?
324
- return result
344
+ throw :response, result
325
345
  end
326
346
  rescue ::Gapic::Rest::Error => e
327
347
  raise ::Google::Cloud::Error.from_error(e)
@@ -413,7 +433,6 @@ module Google
413
433
 
414
434
  @cloud_channel_service_stub.get_customer request, options do |result, operation|
415
435
  yield result, operation if block_given?
416
- return result
417
436
  end
418
437
  rescue ::Gapic::Rest::Error => e
419
438
  raise ::Google::Cloud::Error.from_error(e)
@@ -518,7 +537,6 @@ module Google
518
537
 
519
538
  @cloud_channel_service_stub.check_cloud_identity_accounts_exist request, options do |result, operation|
520
539
  yield result, operation if block_given?
521
- return result
522
540
  end
523
541
  rescue ::Gapic::Rest::Error => e
524
542
  raise ::Google::Cloud::Error.from_error(e)
@@ -615,7 +633,6 @@ module Google
615
633
 
616
634
  @cloud_channel_service_stub.create_customer request, options do |result, operation|
617
635
  yield result, operation if block_given?
618
- return result
619
636
  end
620
637
  rescue ::Gapic::Rest::Error => e
621
638
  raise ::Google::Cloud::Error.from_error(e)
@@ -709,7 +726,6 @@ module Google
709
726
 
710
727
  @cloud_channel_service_stub.update_customer request, options do |result, operation|
711
728
  yield result, operation if block_given?
712
- return result
713
729
  end
714
730
  rescue ::Gapic::Rest::Error => e
715
731
  raise ::Google::Cloud::Error.from_error(e)
@@ -797,7 +813,6 @@ module Google
797
813
 
798
814
  @cloud_channel_service_stub.delete_customer request, options do |result, operation|
799
815
  yield result, operation if block_given?
800
- return result
801
816
  end
802
817
  rescue ::Gapic::Rest::Error => e
803
818
  raise ::Google::Cloud::Error.from_error(e)
@@ -921,7 +936,6 @@ module Google
921
936
 
922
937
  @cloud_channel_service_stub.import_customer request, options do |result, operation|
923
938
  yield result, operation if block_given?
924
- return result
925
939
  end
926
940
  rescue ::Gapic::Rest::Error => e
927
941
  raise ::Google::Cloud::Error.from_error(e)
@@ -1038,7 +1052,7 @@ module Google
1038
1052
  @cloud_channel_service_stub.provision_cloud_identity request, options do |result, operation|
1039
1053
  result = ::Gapic::Operation.new result, @operations_client, options: options
1040
1054
  yield result, operation if block_given?
1041
- return result
1055
+ throw :response, result
1042
1056
  end
1043
1057
  rescue ::Gapic::Rest::Error => e
1044
1058
  raise ::Google::Cloud::Error.from_error(e)
@@ -1145,7 +1159,7 @@ module Google
1145
1159
  @cloud_channel_service_stub.list_entitlements request, options do |result, operation|
1146
1160
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlements, "entitlements", request, result, options
1147
1161
  yield result, operation if block_given?
1148
- return result
1162
+ throw :response, result
1149
1163
  end
1150
1164
  rescue ::Gapic::Rest::Error => e
1151
1165
  raise ::Google::Cloud::Error.from_error(e)
@@ -1277,7 +1291,7 @@ module Google
1277
1291
  @cloud_channel_service_stub.list_transferable_skus request, options do |result, operation|
1278
1292
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_skus, "transferable_skus", request, result, options
1279
1293
  yield result, operation if block_given?
1280
- return result
1294
+ throw :response, result
1281
1295
  end
1282
1296
  rescue ::Gapic::Rest::Error => e
1283
1297
  raise ::Google::Cloud::Error.from_error(e)
@@ -1410,7 +1424,7 @@ module Google
1410
1424
  @cloud_channel_service_stub.list_transferable_offers request, options do |result, operation|
1411
1425
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_transferable_offers, "transferable_offers", request, result, options
1412
1426
  yield result, operation if block_given?
1413
- return result
1427
+ throw :response, result
1414
1428
  end
1415
1429
  rescue ::Gapic::Rest::Error => e
1416
1430
  raise ::Google::Cloud::Error.from_error(e)
@@ -1501,7 +1515,6 @@ module Google
1501
1515
 
1502
1516
  @cloud_channel_service_stub.get_entitlement request, options do |result, operation|
1503
1517
  yield result, operation if block_given?
1504
- return result
1505
1518
  end
1506
1519
  rescue ::Gapic::Rest::Error => e
1507
1520
  raise ::Google::Cloud::Error.from_error(e)
@@ -1643,7 +1656,7 @@ module Google
1643
1656
  @cloud_channel_service_stub.create_entitlement request, options do |result, operation|
1644
1657
  result = ::Gapic::Operation.new result, @operations_client, options: options
1645
1658
  yield result, operation if block_given?
1646
- return result
1659
+ throw :response, result
1647
1660
  end
1648
1661
  rescue ::Gapic::Rest::Error => e
1649
1662
  raise ::Google::Cloud::Error.from_error(e)
@@ -1776,7 +1789,7 @@ module Google
1776
1789
  @cloud_channel_service_stub.change_parameters request, options do |result, operation|
1777
1790
  result = ::Gapic::Operation.new result, @operations_client, options: options
1778
1791
  yield result, operation if block_given?
1779
- return result
1792
+ throw :response, result
1780
1793
  end
1781
1794
  rescue ::Gapic::Rest::Error => e
1782
1795
  raise ::Google::Cloud::Error.from_error(e)
@@ -1902,7 +1915,7 @@ module Google
1902
1915
  @cloud_channel_service_stub.change_renewal_settings request, options do |result, operation|
1903
1916
  result = ::Gapic::Operation.new result, @operations_client, options: options
1904
1917
  yield result, operation if block_given?
1905
- return result
1918
+ throw :response, result
1906
1919
  end
1907
1920
  rescue ::Gapic::Rest::Error => e
1908
1921
  raise ::Google::Cloud::Error.from_error(e)
@@ -2040,7 +2053,7 @@ module Google
2040
2053
  @cloud_channel_service_stub.change_offer request, options do |result, operation|
2041
2054
  result = ::Gapic::Operation.new result, @operations_client, options: options
2042
2055
  yield result, operation if block_given?
2043
- return result
2056
+ throw :response, result
2044
2057
  end
2045
2058
  rescue ::Gapic::Rest::Error => e
2046
2059
  raise ::Google::Cloud::Error.from_error(e)
@@ -2165,7 +2178,7 @@ module Google
2165
2178
  @cloud_channel_service_stub.start_paid_service request, options do |result, operation|
2166
2179
  result = ::Gapic::Operation.new result, @operations_client, options: options
2167
2180
  yield result, operation if block_given?
2168
- return result
2181
+ throw :response, result
2169
2182
  end
2170
2183
  rescue ::Gapic::Rest::Error => e
2171
2184
  raise ::Google::Cloud::Error.from_error(e)
@@ -2287,7 +2300,7 @@ module Google
2287
2300
  @cloud_channel_service_stub.suspend_entitlement request, options do |result, operation|
2288
2301
  result = ::Gapic::Operation.new result, @operations_client, options: options
2289
2302
  yield result, operation if block_given?
2290
- return result
2303
+ throw :response, result
2291
2304
  end
2292
2305
  rescue ::Gapic::Rest::Error => e
2293
2306
  raise ::Google::Cloud::Error.from_error(e)
@@ -2414,7 +2427,7 @@ module Google
2414
2427
  @cloud_channel_service_stub.cancel_entitlement request, options do |result, operation|
2415
2428
  result = ::Gapic::Operation.new result, @operations_client, options: options
2416
2429
  yield result, operation if block_given?
2417
- return result
2430
+ throw :response, result
2418
2431
  end
2419
2432
  rescue ::Gapic::Rest::Error => e
2420
2433
  raise ::Google::Cloud::Error.from_error(e)
@@ -2542,7 +2555,7 @@ module Google
2542
2555
  @cloud_channel_service_stub.activate_entitlement request, options do |result, operation|
2543
2556
  result = ::Gapic::Operation.new result, @operations_client, options: options
2544
2557
  yield result, operation if block_given?
2545
- return result
2558
+ throw :response, result
2546
2559
  end
2547
2560
  rescue ::Gapic::Rest::Error => e
2548
2561
  raise ::Google::Cloud::Error.from_error(e)
@@ -2682,7 +2695,7 @@ module Google
2682
2695
  @cloud_channel_service_stub.transfer_entitlements request, options do |result, operation|
2683
2696
  result = ::Gapic::Operation.new result, @operations_client, options: options
2684
2697
  yield result, operation if block_given?
2685
- return result
2698
+ throw :response, result
2686
2699
  end
2687
2700
  rescue ::Gapic::Rest::Error => e
2688
2701
  raise ::Google::Cloud::Error.from_error(e)
@@ -2814,7 +2827,7 @@ module Google
2814
2827
  @cloud_channel_service_stub.transfer_entitlements_to_google request, options do |result, operation|
2815
2828
  result = ::Gapic::Operation.new result, @operations_client, options: options
2816
2829
  yield result, operation if block_given?
2817
- return result
2830
+ throw :response, result
2818
2831
  end
2819
2832
  rescue ::Gapic::Rest::Error => e
2820
2833
  raise ::Google::Cloud::Error.from_error(e)
@@ -2923,7 +2936,7 @@ module Google
2923
2936
  @cloud_channel_service_stub.list_channel_partner_links request, options do |result, operation|
2924
2937
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_links, "channel_partner_links", request, result, options
2925
2938
  yield result, operation if block_given?
2926
- return result
2939
+ throw :response, result
2927
2940
  end
2928
2941
  rescue ::Gapic::Rest::Error => e
2929
2942
  raise ::Google::Cloud::Error.from_error(e)
@@ -3020,7 +3033,6 @@ module Google
3020
3033
 
3021
3034
  @cloud_channel_service_stub.get_channel_partner_link request, options do |result, operation|
3022
3035
  yield result, operation if block_given?
3023
- return result
3024
3036
  end
3025
3037
  rescue ::Gapic::Rest::Error => e
3026
3038
  raise ::Google::Cloud::Error.from_error(e)
@@ -3127,7 +3139,6 @@ module Google
3127
3139
 
3128
3140
  @cloud_channel_service_stub.create_channel_partner_link request, options do |result, operation|
3129
3141
  yield result, operation if block_given?
3130
- return result
3131
3142
  end
3132
3143
  rescue ::Gapic::Rest::Error => e
3133
3144
  raise ::Google::Cloud::Error.from_error(e)
@@ -3236,7 +3247,6 @@ module Google
3236
3247
 
3237
3248
  @cloud_channel_service_stub.update_channel_partner_link request, options do |result, operation|
3238
3249
  yield result, operation if block_given?
3239
- return result
3240
3250
  end
3241
3251
  rescue ::Gapic::Rest::Error => e
3242
3252
  raise ::Google::Cloud::Error.from_error(e)
@@ -3333,7 +3343,6 @@ module Google
3333
3343
 
3334
3344
  @cloud_channel_service_stub.get_customer_repricing_config request, options do |result, operation|
3335
3345
  yield result, operation if block_given?
3336
- return result
3337
3346
  end
3338
3347
  rescue ::Gapic::Rest::Error => e
3339
3348
  raise ::Google::Cloud::Error.from_error(e)
@@ -3463,7 +3472,7 @@ module Google
3463
3472
  @cloud_channel_service_stub.list_customer_repricing_configs request, options do |result, operation|
3464
3473
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_customer_repricing_configs, "customer_repricing_configs", request, result, options
3465
3474
  yield result, operation if block_given?
3466
- return result
3475
+ throw :response, result
3467
3476
  end
3468
3477
  rescue ::Gapic::Rest::Error => e
3469
3478
  raise ::Google::Cloud::Error.from_error(e)
@@ -3587,7 +3596,6 @@ module Google
3587
3596
 
3588
3597
  @cloud_channel_service_stub.create_customer_repricing_config request, options do |result, operation|
3589
3598
  yield result, operation if block_given?
3590
- return result
3591
3599
  end
3592
3600
  rescue ::Gapic::Rest::Error => e
3593
3601
  raise ::Google::Cloud::Error.from_error(e)
@@ -3697,7 +3705,6 @@ module Google
3697
3705
 
3698
3706
  @cloud_channel_service_stub.update_customer_repricing_config request, options do |result, operation|
3699
3707
  yield result, operation if block_given?
3700
- return result
3701
3708
  end
3702
3709
  rescue ::Gapic::Rest::Error => e
3703
3710
  raise ::Google::Cloud::Error.from_error(e)
@@ -3794,7 +3801,6 @@ module Google
3794
3801
 
3795
3802
  @cloud_channel_service_stub.delete_customer_repricing_config request, options do |result, operation|
3796
3803
  yield result, operation if block_given?
3797
- return result
3798
3804
  end
3799
3805
  rescue ::Gapic::Rest::Error => e
3800
3806
  raise ::Google::Cloud::Error.from_error(e)
@@ -3891,7 +3897,6 @@ module Google
3891
3897
 
3892
3898
  @cloud_channel_service_stub.get_channel_partner_repricing_config request, options do |result, operation|
3893
3899
  yield result, operation if block_given?
3894
- return result
3895
3900
  end
3896
3901
  rescue ::Gapic::Rest::Error => e
3897
3902
  raise ::Google::Cloud::Error.from_error(e)
@@ -4024,7 +4029,7 @@ module Google
4024
4029
  @cloud_channel_service_stub.list_channel_partner_repricing_configs request, options do |result, operation|
4025
4030
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_channel_partner_repricing_configs, "channel_partner_repricing_configs", request, result, options
4026
4031
  yield result, operation if block_given?
4027
- return result
4032
+ throw :response, result
4028
4033
  end
4029
4034
  rescue ::Gapic::Rest::Error => e
4030
4035
  raise ::Google::Cloud::Error.from_error(e)
@@ -4149,7 +4154,6 @@ module Google
4149
4154
 
4150
4155
  @cloud_channel_service_stub.create_channel_partner_repricing_config request, options do |result, operation|
4151
4156
  yield result, operation if block_given?
4152
- return result
4153
4157
  end
4154
4158
  rescue ::Gapic::Rest::Error => e
4155
4159
  raise ::Google::Cloud::Error.from_error(e)
@@ -4259,7 +4263,6 @@ module Google
4259
4263
 
4260
4264
  @cloud_channel_service_stub.update_channel_partner_repricing_config request, options do |result, operation|
4261
4265
  yield result, operation if block_given?
4262
- return result
4263
4266
  end
4264
4267
  rescue ::Gapic::Rest::Error => e
4265
4268
  raise ::Google::Cloud::Error.from_error(e)
@@ -4355,7 +4358,6 @@ module Google
4355
4358
 
4356
4359
  @cloud_channel_service_stub.delete_channel_partner_repricing_config request, options do |result, operation|
4357
4360
  yield result, operation if block_given?
4358
- return result
4359
4361
  end
4360
4362
  rescue ::Gapic::Rest::Error => e
4361
4363
  raise ::Google::Cloud::Error.from_error(e)
@@ -4469,7 +4471,7 @@ module Google
4469
4471
  @cloud_channel_service_stub.list_sku_groups request, options do |result, operation|
4470
4472
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_groups, "sku_groups", request, result, options
4471
4473
  yield result, operation if block_given?
4472
- return result
4474
+ throw :response, result
4473
4475
  end
4474
4476
  rescue ::Gapic::Rest::Error => e
4475
4477
  raise ::Google::Cloud::Error.from_error(e)
@@ -4582,7 +4584,7 @@ module Google
4582
4584
  @cloud_channel_service_stub.list_sku_group_billable_skus request, options do |result, operation|
4583
4585
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_sku_group_billable_skus, "billable_skus", request, result, options
4584
4586
  yield result, operation if block_given?
4585
- return result
4587
+ throw :response, result
4586
4588
  end
4587
4589
  rescue ::Gapic::Rest::Error => e
4588
4590
  raise ::Google::Cloud::Error.from_error(e)
@@ -4672,7 +4674,6 @@ module Google
4672
4674
 
4673
4675
  @cloud_channel_service_stub.lookup_offer request, options do |result, operation|
4674
4676
  yield result, operation if block_given?
4675
- return result
4676
4677
  end
4677
4678
  rescue ::Gapic::Rest::Error => e
4678
4679
  raise ::Google::Cloud::Error.from_error(e)
@@ -4771,7 +4772,7 @@ module Google
4771
4772
  @cloud_channel_service_stub.list_products request, options do |result, operation|
4772
4773
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_products, "products", request, result, options
4773
4774
  yield result, operation if block_given?
4774
- return result
4775
+ throw :response, result
4775
4776
  end
4776
4777
  rescue ::Gapic::Rest::Error => e
4777
4778
  raise ::Google::Cloud::Error.from_error(e)
@@ -4875,7 +4876,7 @@ module Google
4875
4876
  @cloud_channel_service_stub.list_skus request, options do |result, operation|
4876
4877
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_skus, "skus", request, result, options
4877
4878
  yield result, operation if block_given?
4878
- return result
4879
+ throw :response, result
4879
4880
  end
4880
4881
  rescue ::Gapic::Rest::Error => e
4881
4882
  raise ::Google::Cloud::Error.from_error(e)
@@ -4985,7 +4986,7 @@ module Google
4985
4986
  @cloud_channel_service_stub.list_offers request, options do |result, operation|
4986
4987
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_offers, "offers", request, result, options
4987
4988
  yield result, operation if block_given?
4988
- return result
4989
+ throw :response, result
4989
4990
  end
4990
4991
  rescue ::Gapic::Rest::Error => e
4991
4992
  raise ::Google::Cloud::Error.from_error(e)
@@ -5092,7 +5093,7 @@ module Google
5092
5093
  @cloud_channel_service_stub.list_purchasable_skus request, options do |result, operation|
5093
5094
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_skus, "purchasable_skus", request, result, options
5094
5095
  yield result, operation if block_given?
5095
- return result
5096
+ throw :response, result
5096
5097
  end
5097
5098
  rescue ::Gapic::Rest::Error => e
5098
5099
  raise ::Google::Cloud::Error.from_error(e)
@@ -5202,7 +5203,7 @@ module Google
5202
5203
  @cloud_channel_service_stub.list_purchasable_offers request, options do |result, operation|
5203
5204
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_purchasable_offers, "purchasable_offers", request, result, options
5204
5205
  yield result, operation if block_given?
5205
- return result
5206
+ throw :response, result
5206
5207
  end
5207
5208
  rescue ::Gapic::Rest::Error => e
5208
5209
  raise ::Google::Cloud::Error.from_error(e)
@@ -5296,7 +5297,6 @@ module Google
5296
5297
 
5297
5298
  @cloud_channel_service_stub.query_eligible_billing_accounts request, options do |result, operation|
5298
5299
  yield result, operation if block_given?
5299
- return result
5300
5300
  end
5301
5301
  rescue ::Gapic::Rest::Error => e
5302
5302
  raise ::Google::Cloud::Error.from_error(e)
@@ -5395,7 +5395,6 @@ module Google
5395
5395
 
5396
5396
  @cloud_channel_service_stub.register_subscriber request, options do |result, operation|
5397
5397
  yield result, operation if block_given?
5398
- return result
5399
5398
  end
5400
5399
  rescue ::Gapic::Rest::Error => e
5401
5400
  raise ::Google::Cloud::Error.from_error(e)
@@ -5497,7 +5496,6 @@ module Google
5497
5496
 
5498
5497
  @cloud_channel_service_stub.unregister_subscriber request, options do |result, operation|
5499
5498
  yield result, operation if block_given?
5500
- return result
5501
5499
  end
5502
5500
  rescue ::Gapic::Rest::Error => e
5503
5501
  raise ::Google::Cloud::Error.from_error(e)
@@ -5604,7 +5602,7 @@ module Google
5604
5602
  @cloud_channel_service_stub.list_subscribers request, options do |result, operation|
5605
5603
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_subscribers, "service_accounts", request, result, options
5606
5604
  yield result, operation if block_given?
5607
- return result
5605
+ throw :response, result
5608
5606
  end
5609
5607
  rescue ::Gapic::Rest::Error => e
5610
5608
  raise ::Google::Cloud::Error.from_error(e)
@@ -5723,7 +5721,7 @@ module Google
5723
5721
  @cloud_channel_service_stub.list_entitlement_changes request, options do |result, operation|
5724
5722
  result = ::Gapic::Rest::PagedEnumerable.new @cloud_channel_service_stub, :list_entitlement_changes, "entitlement_changes", request, result, options
5725
5723
  yield result, operation if block_given?
5726
- return result
5724
+ throw :response, result
5727
5725
  end
5728
5726
  rescue ::Gapic::Rest::Error => e
5729
5727
  raise ::Google::Cloud::Error.from_error(e)
@@ -5803,6 +5801,11 @@ module Google
5803
5801
  # default endpoint URL. The default value of nil uses the environment
5804
5802
  # universe (usually the default "googleapis.com" universe).
5805
5803
  # @return [::String,nil]
5804
+ # @!attribute [rw] logger
5805
+ # A custom logger to use for request/response debug logging, or the value
5806
+ # `:default` (the default) to construct a default logger, or `nil` to
5807
+ # explicitly disable logging.
5808
+ # @return [::Logger,:default,nil]
5806
5809
  #
5807
5810
  class Configuration
5808
5811
  extend ::Gapic::Config
@@ -5824,6 +5827,7 @@ module Google
5824
5827
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
5825
5828
  config_attr :quota_project, nil, ::String, nil
5826
5829
  config_attr :universe_domain, nil, ::String, nil
5830
+ config_attr :logger, :default, ::Logger, nil, :default
5827
5831
 
5828
5832
  # @private
5829
5833
  def initialize parent_config = nil
@@ -115,14 +115,6 @@ module Google
115
115
  # Lists operations that match the specified filter in the request. If the
116
116
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
117
117
  #
118
- # NOTE: the `name` binding allows API services to override the binding
119
- # to use different resource name schemes, such as `users/*/operations`. To
120
- # override the binding, API services can add a binding such as
121
- # `"/v1/{name=users/*}/operations"` to their service configuration.
122
- # For backwards compatibility, the default name includes the operations
123
- # collection id, however overriding users must ensure the name binding
124
- # is the parent resource, without the operations collection id.
125
- #
126
118
  # @overload list_operations(request, options = nil)
127
119
  # Pass arguments to `list_operations` via a request object, either of type
128
120
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -204,7 +196,7 @@ module Google
204
196
  @operations_stub.list_operations request, options do |result, operation|
205
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
206
198
  yield result, operation if block_given?
207
- return result
199
+ throw :response, result
208
200
  end
209
201
  rescue ::Gapic::Rest::Error => e
210
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -293,7 +285,7 @@ module Google
293
285
  @operations_stub.get_operation request, options do |result, operation|
294
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
295
287
  yield result, operation if block_given?
296
- return result
288
+ throw :response, result
297
289
  end
298
290
  rescue ::Gapic::Rest::Error => e
299
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -375,7 +367,6 @@ module Google
375
367
 
376
368
  @operations_stub.delete_operation request, options do |result, operation|
377
369
  yield result, operation if block_given?
378
- return result
379
370
  end
380
371
  rescue ::Gapic::Rest::Error => e
381
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -390,8 +381,9 @@ module Google
390
381
  # other methods to check whether the cancellation succeeded or whether the
391
382
  # operation completed despite cancellation. On successful cancellation,
392
383
  # the operation is not deleted; instead, it becomes an operation with
393
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
394
- # corresponding to `Code.CANCELLED`.
384
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
385
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
386
+ # `Code.CANCELLED`.
395
387
  #
396
388
  # @overload cancel_operation(request, options = nil)
397
389
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -463,7 +455,6 @@ module Google
463
455
 
464
456
  @operations_stub.cancel_operation request, options do |result, operation|
465
457
  yield result, operation if block_given?
466
- return result
467
458
  end
468
459
  rescue ::Gapic::Rest::Error => e
469
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -543,6 +534,11 @@ module Google
543
534
  # default endpoint URL. The default value of nil uses the environment
544
535
  # universe (usually the default "googleapis.com" universe).
545
536
  # @return [::String,nil]
537
+ # @!attribute [rw] logger
538
+ # A custom logger to use for request/response debug logging, or the value
539
+ # `:default` (the default) to construct a default logger, or `nil` to
540
+ # explicitly disable logging.
541
+ # @return [::Logger,:default,nil]
546
542
  #
547
543
  class Configuration
548
544
  extend ::Gapic::Config
@@ -564,6 +560,7 @@ module Google
564
560
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
565
561
  config_attr :quota_project, nil, ::String, nil
566
562
  config_attr :universe_domain, nil, ::String, nil
563
+ config_attr :logger, :default, ::Logger, nil, :default
567
564
 
568
565
  # @private
569
566
  def initialize parent_config = nil
@@ -683,16 +680,18 @@ module Google
683
680
 
684
681
  response = @client_stub.make_http_request(
685
682
  verb,
686
- uri: uri,
687
- body: body || "",
688
- params: query_string_params,
683
+ uri: uri,
684
+ body: body || "",
685
+ params: query_string_params,
686
+ method_name: "list_operations",
689
687
  options: options
690
688
  )
691
689
  operation = ::Gapic::Rest::TransportOperation.new response
692
690
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
693
-
694
- yield result, operation if block_given?
695
- result
691
+ catch :response do
692
+ yield result, operation if block_given?
693
+ result
694
+ end
696
695
  end
697
696
 
698
697
  ##
@@ -721,16 +720,18 @@ module Google
721
720
 
722
721
  response = @client_stub.make_http_request(
723
722
  verb,
724
- uri: uri,
725
- body: body || "",
726
- params: query_string_params,
723
+ uri: uri,
724
+ body: body || "",
725
+ params: query_string_params,
726
+ method_name: "get_operation",
727
727
  options: options
728
728
  )
729
729
  operation = ::Gapic::Rest::TransportOperation.new response
730
730
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
731
-
732
- yield result, operation if block_given?
733
- result
731
+ catch :response do
732
+ yield result, operation if block_given?
733
+ result
734
+ end
734
735
  end
735
736
 
736
737
  ##
@@ -759,16 +760,18 @@ module Google
759
760
 
760
761
  response = @client_stub.make_http_request(
761
762
  verb,
762
- uri: uri,
763
- body: body || "",
764
- params: query_string_params,
763
+ uri: uri,
764
+ body: body || "",
765
+ params: query_string_params,
766
+ method_name: "delete_operation",
765
767
  options: options
766
768
  )
767
769
  operation = ::Gapic::Rest::TransportOperation.new response
768
770
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
769
-
770
- yield result, operation if block_given?
771
- result
771
+ catch :response do
772
+ yield result, operation if block_given?
773
+ result
774
+ end
772
775
  end
773
776
 
774
777
  ##
@@ -797,16 +800,18 @@ module Google
797
800
 
798
801
  response = @client_stub.make_http_request(
799
802
  verb,
800
- uri: uri,
801
- body: body || "",
802
- params: query_string_params,
803
+ uri: uri,
804
+ body: body || "",
805
+ params: query_string_params,
806
+ method_name: "cancel_operation",
803
807
  options: options
804
808
  )
805
809
  operation = ::Gapic::Rest::TransportOperation.new response
806
810
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
807
-
808
- yield result, operation if block_given?
809
- result
811
+ catch :response do
812
+ yield result, operation if block_given?
813
+ result
814
+ end
810
815
  end
811
816
 
812
817
  ##