google-cloud-bigquery-reservation-v1 1.1.0 → 1.2.0

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