google-cloud-bigquery-reservation-v1 1.1.0 → 1.2.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: a791d0e812a458a5dd01f8f25981bdb6e1511003869abc063fb1cbf8ffda9622
4
- data.tar.gz: a4f27ba0dc32aa85f46ac70b6c1717612e0d822318ae300c3f2bfdcd06de40fc
3
+ metadata.gz: 27045865f03aa3212fa51414b61ec78e90702cd5c43e5b63e02fe3d6e37a8481
4
+ data.tar.gz: 1dd328b12e87d03817c099917b0edd5d22c1fa7cf65b1c4421886e43225df64c
5
5
  SHA512:
6
- metadata.gz: 8b99921bf6b0405e42947050c87986f7853de0e26d8b7fbac740d58f5cb7a1df99e7a50909152b00d56df3ee55f4afef2c843b4b3d9a68b24cba543658b7a36d
7
- data.tar.gz: d836a0ff3c5fec13dc5634489f70910402f854d61f3db21709de260c82cf0a3f91cc10b3026777f864a254d4f7eb0ab3f3194702e296ad2656e460477defeb5a
6
+ metadata.gz: 24da8f605d2c9507f43d2a64ac2cd3a038bff429ba62d2f704beae1be0ca80543e58b5f8af17b46815451c713a51a77088f12f55affc210a89cddd4cdc7c59d9
7
+ data.tar.gz: a10012d5a4b5b172ce4788a70ed437449892cbc2f311572a53a0c79e705b5aee69ac9fe975d083d9345d50dfb66c9bf915abd8cf1644611ff81b4488041566aa
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/bigquery/docs/reference/reservations)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/bigquery/reservation/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -240,8 +240,28 @@ module Google
240
240
  universe_domain: @config.universe_domain,
241
241
  channel_args: @config.channel_args,
242
242
  interceptors: @config.interceptors,
243
- channel_pool_config: @config.channel_pool
243
+ channel_pool_config: @config.channel_pool,
244
+ logger: @config.logger
244
245
  )
246
+
247
+ @reservation_service_stub.stub_logger&.info do |entry|
248
+ entry.set_system_name
249
+ entry.set_service
250
+ entry.message = "Created client for #{entry.service}"
251
+ entry.set_credentials_fields credentials
252
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
253
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
254
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
255
+ end
256
+ end
257
+
258
+ ##
259
+ # The logger used for request/response debug logging.
260
+ #
261
+ # @return [Logger]
262
+ #
263
+ def logger
264
+ @reservation_service_stub.logger
245
265
  end
246
266
 
247
267
  # Service calls
@@ -333,7 +353,6 @@ module Google
333
353
 
334
354
  @reservation_service_stub.call_rpc :create_reservation, request, options: options do |response, operation|
335
355
  yield response, operation if block_given?
336
- return response
337
356
  end
338
357
  rescue ::GRPC::BadStatus => e
339
358
  raise ::Google::Cloud::Error.from_error(e)
@@ -429,7 +448,7 @@ module Google
429
448
  @reservation_service_stub.call_rpc :list_reservations, request, options: options do |response, operation|
430
449
  response = ::Gapic::PagedEnumerable.new @reservation_service_stub, :list_reservations, request, response, operation, options
431
450
  yield response, operation if block_given?
432
- return response
451
+ throw :response, response
433
452
  end
434
453
  rescue ::GRPC::BadStatus => e
435
454
  raise ::Google::Cloud::Error.from_error(e)
@@ -516,7 +535,6 @@ module Google
516
535
 
517
536
  @reservation_service_stub.call_rpc :get_reservation, request, options: options do |response, operation|
518
537
  yield response, operation if block_given?
519
- return response
520
538
  end
521
539
  rescue ::GRPC::BadStatus => e
522
540
  raise ::Google::Cloud::Error.from_error(e)
@@ -605,7 +623,6 @@ module Google
605
623
 
606
624
  @reservation_service_stub.call_rpc :delete_reservation, request, options: options do |response, operation|
607
625
  yield response, operation if block_given?
608
- return response
609
626
  end
610
627
  rescue ::GRPC::BadStatus => e
611
628
  raise ::Google::Cloud::Error.from_error(e)
@@ -693,7 +710,6 @@ module Google
693
710
 
694
711
  @reservation_service_stub.call_rpc :update_reservation, request, options: options do |response, operation|
695
712
  yield response, operation if block_given?
696
- return response
697
713
  end
698
714
  rescue ::GRPC::BadStatus => e
699
715
  raise ::Google::Cloud::Error.from_error(e)
@@ -784,7 +800,6 @@ module Google
784
800
 
785
801
  @reservation_service_stub.call_rpc :failover_reservation, request, options: options do |response, operation|
786
802
  yield response, operation if block_given?
787
- return response
788
803
  end
789
804
  rescue ::GRPC::BadStatus => e
790
805
  raise ::Google::Cloud::Error.from_error(e)
@@ -882,7 +897,6 @@ module Google
882
897
 
883
898
  @reservation_service_stub.call_rpc :create_capacity_commitment, request, options: options do |response, operation|
884
899
  yield response, operation if block_given?
885
- return response
886
900
  end
887
901
  rescue ::GRPC::BadStatus => e
888
902
  raise ::Google::Cloud::Error.from_error(e)
@@ -978,7 +992,7 @@ module Google
978
992
  @reservation_service_stub.call_rpc :list_capacity_commitments, request, options: options do |response, operation|
979
993
  response = ::Gapic::PagedEnumerable.new @reservation_service_stub, :list_capacity_commitments, request, response, operation, options
980
994
  yield response, operation if block_given?
981
- return response
995
+ throw :response, response
982
996
  end
983
997
  rescue ::GRPC::BadStatus => e
984
998
  raise ::Google::Cloud::Error.from_error(e)
@@ -1065,7 +1079,6 @@ module Google
1065
1079
 
1066
1080
  @reservation_service_stub.call_rpc :get_capacity_commitment, request, options: options do |response, operation|
1067
1081
  yield response, operation if block_given?
1068
- return response
1069
1082
  end
1070
1083
  rescue ::GRPC::BadStatus => e
1071
1084
  raise ::Google::Cloud::Error.from_error(e)
@@ -1158,7 +1171,6 @@ module Google
1158
1171
 
1159
1172
  @reservation_service_stub.call_rpc :delete_capacity_commitment, request, options: options do |response, operation|
1160
1173
  yield response, operation if block_given?
1161
- return response
1162
1174
  end
1163
1175
  rescue ::GRPC::BadStatus => e
1164
1176
  raise ::Google::Cloud::Error.from_error(e)
@@ -1252,7 +1264,6 @@ module Google
1252
1264
 
1253
1265
  @reservation_service_stub.call_rpc :update_capacity_commitment, request, options: options do |response, operation|
1254
1266
  yield response, operation if block_given?
1255
- return response
1256
1267
  end
1257
1268
  rescue ::GRPC::BadStatus => e
1258
1269
  raise ::Google::Cloud::Error.from_error(e)
@@ -1348,7 +1359,6 @@ module Google
1348
1359
 
1349
1360
  @reservation_service_stub.call_rpc :split_capacity_commitment, request, options: options do |response, operation|
1350
1361
  yield response, operation if block_given?
1351
- return response
1352
1362
  end
1353
1363
  rescue ::GRPC::BadStatus => e
1354
1364
  raise ::Google::Cloud::Error.from_error(e)
@@ -1447,7 +1457,6 @@ module Google
1447
1457
 
1448
1458
  @reservation_service_stub.call_rpc :merge_capacity_commitments, request, options: options do |response, operation|
1449
1459
  yield response, operation if block_given?
1450
- return response
1451
1460
  end
1452
1461
  rescue ::GRPC::BadStatus => e
1453
1462
  raise ::Google::Cloud::Error.from_error(e)
@@ -1575,7 +1584,6 @@ module Google
1575
1584
 
1576
1585
  @reservation_service_stub.call_rpc :create_assignment, request, options: options do |response, operation|
1577
1586
  yield response, operation if block_given?
1578
- return response
1579
1587
  end
1580
1588
  rescue ::GRPC::BadStatus => e
1581
1589
  raise ::Google::Cloud::Error.from_error(e)
@@ -1696,7 +1704,7 @@ module Google
1696
1704
  @reservation_service_stub.call_rpc :list_assignments, request, options: options do |response, operation|
1697
1705
  response = ::Gapic::PagedEnumerable.new @reservation_service_stub, :list_assignments, request, response, operation, options
1698
1706
  yield response, operation if block_given?
1699
- return response
1707
+ throw :response, response
1700
1708
  end
1701
1709
  rescue ::GRPC::BadStatus => e
1702
1710
  raise ::Google::Cloud::Error.from_error(e)
@@ -1797,7 +1805,6 @@ module Google
1797
1805
 
1798
1806
  @reservation_service_stub.call_rpc :delete_assignment, request, options: options do |response, operation|
1799
1807
  yield response, operation if block_given?
1800
- return response
1801
1808
  end
1802
1809
  rescue ::GRPC::BadStatus => e
1803
1810
  raise ::Google::Cloud::Error.from_error(e)
@@ -1926,7 +1933,7 @@ module Google
1926
1933
  @reservation_service_stub.call_rpc :search_assignments, request, options: options do |response, operation|
1927
1934
  response = ::Gapic::PagedEnumerable.new @reservation_service_stub, :search_assignments, request, response, operation, options
1928
1935
  yield response, operation if block_given?
1929
- return response
1936
+ throw :response, response
1930
1937
  end
1931
1938
  rescue ::GRPC::BadStatus => e
1932
1939
  raise ::Google::Cloud::Error.from_error(e)
@@ -2050,7 +2057,7 @@ module Google
2050
2057
  @reservation_service_stub.call_rpc :search_all_assignments, request, options: options do |response, operation|
2051
2058
  response = ::Gapic::PagedEnumerable.new @reservation_service_stub, :search_all_assignments, request, response, operation, options
2052
2059
  yield response, operation if block_given?
2053
- return response
2060
+ throw :response, response
2054
2061
  end
2055
2062
  rescue ::GRPC::BadStatus => e
2056
2063
  raise ::Google::Cloud::Error.from_error(e)
@@ -2151,7 +2158,6 @@ module Google
2151
2158
 
2152
2159
  @reservation_service_stub.call_rpc :move_assignment, request, options: options do |response, operation|
2153
2160
  yield response, operation if block_given?
2154
- return response
2155
2161
  end
2156
2162
  rescue ::GRPC::BadStatus => e
2157
2163
  raise ::Google::Cloud::Error.from_error(e)
@@ -2241,7 +2247,6 @@ module Google
2241
2247
 
2242
2248
  @reservation_service_stub.call_rpc :update_assignment, request, options: options do |response, operation|
2243
2249
  yield response, operation if block_given?
2244
- return response
2245
2250
  end
2246
2251
  rescue ::GRPC::BadStatus => e
2247
2252
  raise ::Google::Cloud::Error.from_error(e)
@@ -2328,7 +2333,6 @@ module Google
2328
2333
 
2329
2334
  @reservation_service_stub.call_rpc :get_bi_reservation, request, options: options do |response, operation|
2330
2335
  yield response, operation if block_given?
2331
- return response
2332
2336
  end
2333
2337
  rescue ::GRPC::BadStatus => e
2334
2338
  raise ::Google::Cloud::Error.from_error(e)
@@ -2423,7 +2427,6 @@ module Google
2423
2427
 
2424
2428
  @reservation_service_stub.call_rpc :update_bi_reservation, request, options: options do |response, operation|
2425
2429
  yield response, operation if block_given?
2426
- return response
2427
2430
  end
2428
2431
  rescue ::GRPC::BadStatus => e
2429
2432
  raise ::Google::Cloud::Error.from_error(e)
@@ -2512,6 +2515,11 @@ module Google
2512
2515
  # default endpoint URL. The default value of nil uses the environment
2513
2516
  # universe (usually the default "googleapis.com" universe).
2514
2517
  # @return [::String,nil]
2518
+ # @!attribute [rw] logger
2519
+ # A custom logger to use for request/response debug logging, or the value
2520
+ # `:default` (the default) to construct a default logger, or `nil` to
2521
+ # explicitly disable logging.
2522
+ # @return [::Logger,:default,nil]
2515
2523
  #
2516
2524
  class Configuration
2517
2525
  extend ::Gapic::Config
@@ -2536,6 +2544,7 @@ module Google
2536
2544
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2537
2545
  config_attr :quota_project, nil, ::String, nil
2538
2546
  config_attr :universe_domain, nil, ::String, nil
2547
+ config_attr :logger, :default, ::Logger, nil, :default
2539
2548
 
2540
2549
  # @private
2541
2550
  def initialize parent_config = nil
@@ -233,8 +233,28 @@ module Google
233
233
  endpoint: @config.endpoint,
234
234
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
235
235
  universe_domain: @config.universe_domain,
236
- credentials: credentials
236
+ credentials: credentials,
237
+ logger: @config.logger
237
238
  )
239
+
240
+ @reservation_service_stub.logger(stub: true)&.info do |entry|
241
+ entry.set_system_name
242
+ entry.set_service
243
+ entry.message = "Created client for #{entry.service}"
244
+ entry.set_credentials_fields credentials
245
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
246
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
247
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
248
+ end
249
+ end
250
+
251
+ ##
252
+ # The logger used for request/response debug logging.
253
+ #
254
+ # @return [Logger]
255
+ #
256
+ def logger
257
+ @reservation_service_stub.logger
238
258
  end
239
259
 
240
260
  # Service calls
@@ -319,7 +339,6 @@ module Google
319
339
 
320
340
  @reservation_service_stub.create_reservation request, options do |result, operation|
321
341
  yield result, operation if block_given?
322
- return result
323
342
  end
324
343
  rescue ::Gapic::Rest::Error => e
325
344
  raise ::Google::Cloud::Error.from_error(e)
@@ -408,7 +427,7 @@ module Google
408
427
  @reservation_service_stub.list_reservations request, options do |result, operation|
409
428
  result = ::Gapic::Rest::PagedEnumerable.new @reservation_service_stub, :list_reservations, "reservations", request, result, options
410
429
  yield result, operation if block_given?
411
- return result
430
+ throw :response, result
412
431
  end
413
432
  rescue ::Gapic::Rest::Error => e
414
433
  raise ::Google::Cloud::Error.from_error(e)
@@ -488,7 +507,6 @@ module Google
488
507
 
489
508
  @reservation_service_stub.get_reservation request, options do |result, operation|
490
509
  yield result, operation if block_given?
491
- return result
492
510
  end
493
511
  rescue ::Gapic::Rest::Error => e
494
512
  raise ::Google::Cloud::Error.from_error(e)
@@ -570,7 +588,6 @@ module Google
570
588
 
571
589
  @reservation_service_stub.delete_reservation request, options do |result, operation|
572
590
  yield result, operation if block_given?
573
- return result
574
591
  end
575
592
  rescue ::Gapic::Rest::Error => e
576
593
  raise ::Google::Cloud::Error.from_error(e)
@@ -651,7 +668,6 @@ module Google
651
668
 
652
669
  @reservation_service_stub.update_reservation request, options do |result, operation|
653
670
  yield result, operation if block_given?
654
- return result
655
671
  end
656
672
  rescue ::Gapic::Rest::Error => e
657
673
  raise ::Google::Cloud::Error.from_error(e)
@@ -735,7 +751,6 @@ module Google
735
751
 
736
752
  @reservation_service_stub.failover_reservation request, options do |result, operation|
737
753
  yield result, operation if block_given?
738
- return result
739
754
  end
740
755
  rescue ::Gapic::Rest::Error => e
741
756
  raise ::Google::Cloud::Error.from_error(e)
@@ -826,7 +841,6 @@ module Google
826
841
 
827
842
  @reservation_service_stub.create_capacity_commitment request, options do |result, operation|
828
843
  yield result, operation if block_given?
829
- return result
830
844
  end
831
845
  rescue ::Gapic::Rest::Error => e
832
846
  raise ::Google::Cloud::Error.from_error(e)
@@ -915,7 +929,7 @@ module Google
915
929
  @reservation_service_stub.list_capacity_commitments request, options do |result, operation|
916
930
  result = ::Gapic::Rest::PagedEnumerable.new @reservation_service_stub, :list_capacity_commitments, "capacity_commitments", request, result, options
917
931
  yield result, operation if block_given?
918
- return result
932
+ throw :response, result
919
933
  end
920
934
  rescue ::Gapic::Rest::Error => e
921
935
  raise ::Google::Cloud::Error.from_error(e)
@@ -995,7 +1009,6 @@ module Google
995
1009
 
996
1010
  @reservation_service_stub.get_capacity_commitment request, options do |result, operation|
997
1011
  yield result, operation if block_given?
998
- return result
999
1012
  end
1000
1013
  rescue ::Gapic::Rest::Error => e
1001
1014
  raise ::Google::Cloud::Error.from_error(e)
@@ -1081,7 +1094,6 @@ module Google
1081
1094
 
1082
1095
  @reservation_service_stub.delete_capacity_commitment request, options do |result, operation|
1083
1096
  yield result, operation if block_given?
1084
- return result
1085
1097
  end
1086
1098
  rescue ::Gapic::Rest::Error => e
1087
1099
  raise ::Google::Cloud::Error.from_error(e)
@@ -1168,7 +1180,6 @@ module Google
1168
1180
 
1169
1181
  @reservation_service_stub.update_capacity_commitment request, options do |result, operation|
1170
1182
  yield result, operation if block_given?
1171
- return result
1172
1183
  end
1173
1184
  rescue ::Gapic::Rest::Error => e
1174
1185
  raise ::Google::Cloud::Error.from_error(e)
@@ -1257,7 +1268,6 @@ module Google
1257
1268
 
1258
1269
  @reservation_service_stub.split_capacity_commitment request, options do |result, operation|
1259
1270
  yield result, operation if block_given?
1260
- return result
1261
1271
  end
1262
1272
  rescue ::Gapic::Rest::Error => e
1263
1273
  raise ::Google::Cloud::Error.from_error(e)
@@ -1349,7 +1359,6 @@ module Google
1349
1359
 
1350
1360
  @reservation_service_stub.merge_capacity_commitments request, options do |result, operation|
1351
1361
  yield result, operation if block_given?
1352
- return result
1353
1362
  end
1354
1363
  rescue ::Gapic::Rest::Error => e
1355
1364
  raise ::Google::Cloud::Error.from_error(e)
@@ -1470,7 +1479,6 @@ module Google
1470
1479
 
1471
1480
  @reservation_service_stub.create_assignment request, options do |result, operation|
1472
1481
  yield result, operation if block_given?
1473
- return result
1474
1482
  end
1475
1483
  rescue ::Gapic::Rest::Error => e
1476
1484
  raise ::Google::Cloud::Error.from_error(e)
@@ -1584,7 +1592,7 @@ module Google
1584
1592
  @reservation_service_stub.list_assignments request, options do |result, operation|
1585
1593
  result = ::Gapic::Rest::PagedEnumerable.new @reservation_service_stub, :list_assignments, "assignments", request, result, options
1586
1594
  yield result, operation if block_given?
1587
- return result
1595
+ throw :response, result
1588
1596
  end
1589
1597
  rescue ::Gapic::Rest::Error => e
1590
1598
  raise ::Google::Cloud::Error.from_error(e)
@@ -1678,7 +1686,6 @@ module Google
1678
1686
 
1679
1687
  @reservation_service_stub.delete_assignment request, options do |result, operation|
1680
1688
  yield result, operation if block_given?
1681
- return result
1682
1689
  end
1683
1690
  rescue ::Gapic::Rest::Error => e
1684
1691
  raise ::Google::Cloud::Error.from_error(e)
@@ -1798,7 +1805,7 @@ module Google
1798
1805
  @reservation_service_stub.search_assignments request, options do |result, operation|
1799
1806
  result = ::Gapic::Rest::PagedEnumerable.new @reservation_service_stub, :search_assignments, "assignments", request, result, options
1800
1807
  yield result, operation if block_given?
1801
- return result
1808
+ throw :response, result
1802
1809
  end
1803
1810
  rescue ::Gapic::Rest::Error => e
1804
1811
  raise ::Google::Cloud::Error.from_error(e)
@@ -1915,7 +1922,7 @@ module Google
1915
1922
  @reservation_service_stub.search_all_assignments request, options do |result, operation|
1916
1923
  result = ::Gapic::Rest::PagedEnumerable.new @reservation_service_stub, :search_all_assignments, "assignments", request, result, options
1917
1924
  yield result, operation if block_given?
1918
- return result
1925
+ throw :response, result
1919
1926
  end
1920
1927
  rescue ::Gapic::Rest::Error => e
1921
1928
  raise ::Google::Cloud::Error.from_error(e)
@@ -2009,7 +2016,6 @@ module Google
2009
2016
 
2010
2017
  @reservation_service_stub.move_assignment request, options do |result, operation|
2011
2018
  yield result, operation if block_given?
2012
- return result
2013
2019
  end
2014
2020
  rescue ::Gapic::Rest::Error => e
2015
2021
  raise ::Google::Cloud::Error.from_error(e)
@@ -2092,7 +2098,6 @@ module Google
2092
2098
 
2093
2099
  @reservation_service_stub.update_assignment request, options do |result, operation|
2094
2100
  yield result, operation if block_given?
2095
- return result
2096
2101
  end
2097
2102
  rescue ::Gapic::Rest::Error => e
2098
2103
  raise ::Google::Cloud::Error.from_error(e)
@@ -2172,7 +2177,6 @@ module Google
2172
2177
 
2173
2178
  @reservation_service_stub.get_bi_reservation request, options do |result, operation|
2174
2179
  yield result, operation if block_given?
2175
- return result
2176
2180
  end
2177
2181
  rescue ::Gapic::Rest::Error => e
2178
2182
  raise ::Google::Cloud::Error.from_error(e)
@@ -2260,7 +2264,6 @@ module Google
2260
2264
 
2261
2265
  @reservation_service_stub.update_bi_reservation request, options do |result, operation|
2262
2266
  yield result, operation if block_given?
2263
- return result
2264
2267
  end
2265
2268
  rescue ::Gapic::Rest::Error => e
2266
2269
  raise ::Google::Cloud::Error.from_error(e)
@@ -2340,6 +2343,11 @@ module Google
2340
2343
  # default endpoint URL. The default value of nil uses the environment
2341
2344
  # universe (usually the default "googleapis.com" universe).
2342
2345
  # @return [::String,nil]
2346
+ # @!attribute [rw] logger
2347
+ # A custom logger to use for request/response debug logging, or the value
2348
+ # `:default` (the default) to construct a default logger, or `nil` to
2349
+ # explicitly disable logging.
2350
+ # @return [::Logger,:default,nil]
2343
2351
  #
2344
2352
  class Configuration
2345
2353
  extend ::Gapic::Config
@@ -2361,6 +2369,7 @@ module Google
2361
2369
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2362
2370
  config_attr :quota_project, nil, ::String, nil
2363
2371
  config_attr :universe_domain, nil, ::String, nil
2372
+ config_attr :logger, :default, ::Logger, nil, :default
2364
2373
 
2365
2374
  # @private
2366
2375
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the create_reservation REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "create_reservation",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Cloud::Bigquery::Reservation::V1::Reservation.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "list_reservations",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Cloud::Bigquery::Reservation::V1::ListReservationsResponse.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "get_reservation",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Cloud::Bigquery::Reservation::V1::Reservation.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -202,16 +220,18 @@ module Google
202
220
 
203
221
  response = @client_stub.make_http_request(
204
222
  verb,
205
- uri: uri,
206
- body: body || "",
207
- params: query_string_params,
223
+ uri: uri,
224
+ body: body || "",
225
+ params: query_string_params,
226
+ method_name: "delete_reservation",
208
227
  options: options
209
228
  )
210
229
  operation = ::Gapic::Rest::TransportOperation.new response
211
230
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
212
-
213
- yield result, operation if block_given?
214
- result
231
+ catch :response do
232
+ yield result, operation if block_given?
233
+ result
234
+ end
215
235
  end
216
236
 
217
237
  ##
@@ -240,16 +260,18 @@ module Google
240
260
 
241
261
  response = @client_stub.make_http_request(
242
262
  verb,
243
- uri: uri,
244
- body: body || "",
245
- params: query_string_params,
263
+ uri: uri,
264
+ body: body || "",
265
+ params: query_string_params,
266
+ method_name: "update_reservation",
246
267
  options: options
247
268
  )
248
269
  operation = ::Gapic::Rest::TransportOperation.new response
249
270
  result = ::Google::Cloud::Bigquery::Reservation::V1::Reservation.decode_json response.body, ignore_unknown_fields: true
250
-
251
- yield result, operation if block_given?
252
- result
271
+ catch :response do
272
+ yield result, operation if block_given?
273
+ result
274
+ end
253
275
  end
254
276
 
255
277
  ##
@@ -278,16 +300,18 @@ module Google
278
300
 
279
301
  response = @client_stub.make_http_request(
280
302
  verb,
281
- uri: uri,
282
- body: body || "",
283
- params: query_string_params,
303
+ uri: uri,
304
+ body: body || "",
305
+ params: query_string_params,
306
+ method_name: "failover_reservation",
284
307
  options: options
285
308
  )
286
309
  operation = ::Gapic::Rest::TransportOperation.new response
287
310
  result = ::Google::Cloud::Bigquery::Reservation::V1::Reservation.decode_json response.body, ignore_unknown_fields: true
288
-
289
- yield result, operation if block_given?
290
- result
311
+ catch :response do
312
+ yield result, operation if block_given?
313
+ result
314
+ end
291
315
  end
292
316
 
293
317
  ##
@@ -316,16 +340,18 @@ module Google
316
340
 
317
341
  response = @client_stub.make_http_request(
318
342
  verb,
319
- uri: uri,
320
- body: body || "",
321
- params: query_string_params,
343
+ uri: uri,
344
+ body: body || "",
345
+ params: query_string_params,
346
+ method_name: "create_capacity_commitment",
322
347
  options: options
323
348
  )
324
349
  operation = ::Gapic::Rest::TransportOperation.new response
325
350
  result = ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.decode_json response.body, ignore_unknown_fields: true
326
-
327
- yield result, operation if block_given?
328
- result
351
+ catch :response do
352
+ yield result, operation if block_given?
353
+ result
354
+ end
329
355
  end
330
356
 
331
357
  ##
@@ -354,16 +380,18 @@ module Google
354
380
 
355
381
  response = @client_stub.make_http_request(
356
382
  verb,
357
- uri: uri,
358
- body: body || "",
359
- params: query_string_params,
383
+ uri: uri,
384
+ body: body || "",
385
+ params: query_string_params,
386
+ method_name: "list_capacity_commitments",
360
387
  options: options
361
388
  )
362
389
  operation = ::Gapic::Rest::TransportOperation.new response
363
390
  result = ::Google::Cloud::Bigquery::Reservation::V1::ListCapacityCommitmentsResponse.decode_json response.body, ignore_unknown_fields: true
364
-
365
- yield result, operation if block_given?
366
- result
391
+ catch :response do
392
+ yield result, operation if block_given?
393
+ result
394
+ end
367
395
  end
368
396
 
369
397
  ##
@@ -392,16 +420,18 @@ module Google
392
420
 
393
421
  response = @client_stub.make_http_request(
394
422
  verb,
395
- uri: uri,
396
- body: body || "",
397
- params: query_string_params,
423
+ uri: uri,
424
+ body: body || "",
425
+ params: query_string_params,
426
+ method_name: "get_capacity_commitment",
398
427
  options: options
399
428
  )
400
429
  operation = ::Gapic::Rest::TransportOperation.new response
401
430
  result = ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.decode_json response.body, ignore_unknown_fields: true
402
-
403
- yield result, operation if block_given?
404
- result
431
+ catch :response do
432
+ yield result, operation if block_given?
433
+ result
434
+ end
405
435
  end
406
436
 
407
437
  ##
@@ -430,16 +460,18 @@ module Google
430
460
 
431
461
  response = @client_stub.make_http_request(
432
462
  verb,
433
- uri: uri,
434
- body: body || "",
435
- params: query_string_params,
463
+ uri: uri,
464
+ body: body || "",
465
+ params: query_string_params,
466
+ method_name: "delete_capacity_commitment",
436
467
  options: options
437
468
  )
438
469
  operation = ::Gapic::Rest::TransportOperation.new response
439
470
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
440
-
441
- yield result, operation if block_given?
442
- result
471
+ catch :response do
472
+ yield result, operation if block_given?
473
+ result
474
+ end
443
475
  end
444
476
 
445
477
  ##
@@ -468,16 +500,18 @@ module Google
468
500
 
469
501
  response = @client_stub.make_http_request(
470
502
  verb,
471
- uri: uri,
472
- body: body || "",
473
- params: query_string_params,
503
+ uri: uri,
504
+ body: body || "",
505
+ params: query_string_params,
506
+ method_name: "update_capacity_commitment",
474
507
  options: options
475
508
  )
476
509
  operation = ::Gapic::Rest::TransportOperation.new response
477
510
  result = ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.decode_json response.body, ignore_unknown_fields: true
478
-
479
- yield result, operation if block_given?
480
- result
511
+ catch :response do
512
+ yield result, operation if block_given?
513
+ result
514
+ end
481
515
  end
482
516
 
483
517
  ##
@@ -506,16 +540,18 @@ module Google
506
540
 
507
541
  response = @client_stub.make_http_request(
508
542
  verb,
509
- uri: uri,
510
- body: body || "",
511
- params: query_string_params,
543
+ uri: uri,
544
+ body: body || "",
545
+ params: query_string_params,
546
+ method_name: "split_capacity_commitment",
512
547
  options: options
513
548
  )
514
549
  operation = ::Gapic::Rest::TransportOperation.new response
515
550
  result = ::Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentResponse.decode_json response.body, ignore_unknown_fields: true
516
-
517
- yield result, operation if block_given?
518
- result
551
+ catch :response do
552
+ yield result, operation if block_given?
553
+ result
554
+ end
519
555
  end
520
556
 
521
557
  ##
@@ -544,16 +580,18 @@ module Google
544
580
 
545
581
  response = @client_stub.make_http_request(
546
582
  verb,
547
- uri: uri,
548
- body: body || "",
549
- params: query_string_params,
583
+ uri: uri,
584
+ body: body || "",
585
+ params: query_string_params,
586
+ method_name: "merge_capacity_commitments",
550
587
  options: options
551
588
  )
552
589
  operation = ::Gapic::Rest::TransportOperation.new response
553
590
  result = ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.decode_json response.body, ignore_unknown_fields: true
554
-
555
- yield result, operation if block_given?
556
- result
591
+ catch :response do
592
+ yield result, operation if block_given?
593
+ result
594
+ end
557
595
  end
558
596
 
559
597
  ##
@@ -582,16 +620,18 @@ module Google
582
620
 
583
621
  response = @client_stub.make_http_request(
584
622
  verb,
585
- uri: uri,
586
- body: body || "",
587
- params: query_string_params,
623
+ uri: uri,
624
+ body: body || "",
625
+ params: query_string_params,
626
+ method_name: "create_assignment",
588
627
  options: options
589
628
  )
590
629
  operation = ::Gapic::Rest::TransportOperation.new response
591
630
  result = ::Google::Cloud::Bigquery::Reservation::V1::Assignment.decode_json response.body, ignore_unknown_fields: true
592
-
593
- yield result, operation if block_given?
594
- result
631
+ catch :response do
632
+ yield result, operation if block_given?
633
+ result
634
+ end
595
635
  end
596
636
 
597
637
  ##
@@ -620,16 +660,18 @@ module Google
620
660
 
621
661
  response = @client_stub.make_http_request(
622
662
  verb,
623
- uri: uri,
624
- body: body || "",
625
- params: query_string_params,
663
+ uri: uri,
664
+ body: body || "",
665
+ params: query_string_params,
666
+ method_name: "list_assignments",
626
667
  options: options
627
668
  )
628
669
  operation = ::Gapic::Rest::TransportOperation.new response
629
670
  result = ::Google::Cloud::Bigquery::Reservation::V1::ListAssignmentsResponse.decode_json response.body, ignore_unknown_fields: true
630
-
631
- yield result, operation if block_given?
632
- result
671
+ catch :response do
672
+ yield result, operation if block_given?
673
+ result
674
+ end
633
675
  end
634
676
 
635
677
  ##
@@ -658,16 +700,18 @@ module Google
658
700
 
659
701
  response = @client_stub.make_http_request(
660
702
  verb,
661
- uri: uri,
662
- body: body || "",
663
- params: query_string_params,
703
+ uri: uri,
704
+ body: body || "",
705
+ params: query_string_params,
706
+ method_name: "delete_assignment",
664
707
  options: options
665
708
  )
666
709
  operation = ::Gapic::Rest::TransportOperation.new response
667
710
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
668
-
669
- yield result, operation if block_given?
670
- result
711
+ catch :response do
712
+ yield result, operation if block_given?
713
+ result
714
+ end
671
715
  end
672
716
 
673
717
  ##
@@ -696,16 +740,18 @@ module Google
696
740
 
697
741
  response = @client_stub.make_http_request(
698
742
  verb,
699
- uri: uri,
700
- body: body || "",
701
- params: query_string_params,
743
+ uri: uri,
744
+ body: body || "",
745
+ params: query_string_params,
746
+ method_name: "search_assignments",
702
747
  options: options
703
748
  )
704
749
  operation = ::Gapic::Rest::TransportOperation.new response
705
750
  result = ::Google::Cloud::Bigquery::Reservation::V1::SearchAssignmentsResponse.decode_json response.body, ignore_unknown_fields: true
706
-
707
- yield result, operation if block_given?
708
- result
751
+ catch :response do
752
+ yield result, operation if block_given?
753
+ result
754
+ end
709
755
  end
710
756
 
711
757
  ##
@@ -734,16 +780,18 @@ module Google
734
780
 
735
781
  response = @client_stub.make_http_request(
736
782
  verb,
737
- uri: uri,
738
- body: body || "",
739
- params: query_string_params,
783
+ uri: uri,
784
+ body: body || "",
785
+ params: query_string_params,
786
+ method_name: "search_all_assignments",
740
787
  options: options
741
788
  )
742
789
  operation = ::Gapic::Rest::TransportOperation.new response
743
790
  result = ::Google::Cloud::Bigquery::Reservation::V1::SearchAllAssignmentsResponse.decode_json response.body, ignore_unknown_fields: true
744
-
745
- yield result, operation if block_given?
746
- result
791
+ catch :response do
792
+ yield result, operation if block_given?
793
+ result
794
+ end
747
795
  end
748
796
 
749
797
  ##
@@ -772,16 +820,18 @@ module Google
772
820
 
773
821
  response = @client_stub.make_http_request(
774
822
  verb,
775
- uri: uri,
776
- body: body || "",
777
- params: query_string_params,
823
+ uri: uri,
824
+ body: body || "",
825
+ params: query_string_params,
826
+ method_name: "move_assignment",
778
827
  options: options
779
828
  )
780
829
  operation = ::Gapic::Rest::TransportOperation.new response
781
830
  result = ::Google::Cloud::Bigquery::Reservation::V1::Assignment.decode_json response.body, ignore_unknown_fields: true
782
-
783
- yield result, operation if block_given?
784
- result
831
+ catch :response do
832
+ yield result, operation if block_given?
833
+ result
834
+ end
785
835
  end
786
836
 
787
837
  ##
@@ -810,16 +860,18 @@ module Google
810
860
 
811
861
  response = @client_stub.make_http_request(
812
862
  verb,
813
- uri: uri,
814
- body: body || "",
815
- params: query_string_params,
863
+ uri: uri,
864
+ body: body || "",
865
+ params: query_string_params,
866
+ method_name: "update_assignment",
816
867
  options: options
817
868
  )
818
869
  operation = ::Gapic::Rest::TransportOperation.new response
819
870
  result = ::Google::Cloud::Bigquery::Reservation::V1::Assignment.decode_json response.body, ignore_unknown_fields: true
820
-
821
- yield result, operation if block_given?
822
- result
871
+ catch :response do
872
+ yield result, operation if block_given?
873
+ result
874
+ end
823
875
  end
824
876
 
825
877
  ##
@@ -848,16 +900,18 @@ module Google
848
900
 
849
901
  response = @client_stub.make_http_request(
850
902
  verb,
851
- uri: uri,
852
- body: body || "",
853
- params: query_string_params,
903
+ uri: uri,
904
+ body: body || "",
905
+ params: query_string_params,
906
+ method_name: "get_bi_reservation",
854
907
  options: options
855
908
  )
856
909
  operation = ::Gapic::Rest::TransportOperation.new response
857
910
  result = ::Google::Cloud::Bigquery::Reservation::V1::BiReservation.decode_json response.body, ignore_unknown_fields: true
858
-
859
- yield result, operation if block_given?
860
- result
911
+ catch :response do
912
+ yield result, operation if block_given?
913
+ result
914
+ end
861
915
  end
862
916
 
863
917
  ##
@@ -886,16 +940,18 @@ module Google
886
940
 
887
941
  response = @client_stub.make_http_request(
888
942
  verb,
889
- uri: uri,
890
- body: body || "",
891
- params: query_string_params,
943
+ uri: uri,
944
+ body: body || "",
945
+ params: query_string_params,
946
+ method_name: "update_bi_reservation",
892
947
  options: options
893
948
  )
894
949
  operation = ::Gapic::Rest::TransportOperation.new response
895
950
  result = ::Google::Cloud::Bigquery::Reservation::V1::BiReservation.decode_json response.body, ignore_unknown_fields: true
896
-
897
- yield result, operation if block_given?
898
- result
951
+ catch :response do
952
+ yield result, operation if block_given?
953
+ result
954
+ end
899
955
  end
900
956
 
901
957
  ##
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Reservation
24
24
  module V1
25
- VERSION = "1.1.0"
25
+ VERSION = "1.2.0"
26
26
  end
27
27
  end
28
28
  end
@@ -306,9 +306,28 @@ module Google
306
306
  # @!attribute [rw] common
307
307
  # @return [::Google::Api::CommonLanguageSettings]
308
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
309
319
  class GoSettings
310
320
  include ::Google::Protobuf::MessageExts
311
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
312
331
  end
313
332
 
314
333
  # Describes the generator configuration for a method.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-reservation-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.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: 2024-12-04 00:00:00.000000000 Z
11
+ date: 2024-12-10 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.21.1
19
+ version: 0.24.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.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -102,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
102
102
  - !ruby/object:Gem::Version
103
103
  version: '0'
104
104
  requirements: []
105
- rubygems_version: 3.5.22
105
+ rubygems_version: 3.5.23
106
106
  signing_key:
107
107
  specification_version: 4
108
108
  summary: A service to modify your BigQuery flat-rate reservations.