google-cloud-secret_manager-v1 1.0.0 → 1.1.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: ece864f5f498b6ccd0a00df4f877720afc9a02bf7711fc3caf7ceaf56e507e8e
4
- data.tar.gz: 8a89a12f960edcfba837afb73fc6708ddeab35af468a6c452ef3c653b3b9b858
3
+ metadata.gz: 805254148f1731e44c83a83947d20e4bdf921476f464c6c9bc8964ac4ff5318d
4
+ data.tar.gz: f653c8a9ad115464b2704ab2b6be860537a0e0bddb3a32fde81b0b66811555cd
5
5
  SHA512:
6
- metadata.gz: 52a111d540abd37ae0379cf18051811c348bfe174706812d3c6fec73d888edadba6d53e88211b111d0b5a415506b93245952c8f6eef974151245a772eb1cc8f7
7
- data.tar.gz: fbc202bf1732052ade3ddf2cb0018fb7a86c0ef7b5d577fad9306e87296eb182e4e3e166ef844357bb2bc5cb277fe22fde286dd5737be28aa59916c62865f8c9
6
+ metadata.gz: 41db695a4d3a8b1e4963a38ae3d7f80936867cd9203e36b2927ad870ff456f08fc698c362fa62934b5cdd92e580535175b7d215268b135b10adf912578dde34c
7
+ data.tar.gz: b4f3933b3e2c6610c16e474f17d01ef6b704d3bfa4152fe6ddc117717115d07e7af0f07ad162dd058939a8b955518eb9f6cbfefab96307639440351a51fa4c12
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/secret-manager)
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/secret_manager/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::SecretManager::V1::SecretManagerService::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).
@@ -197,14 +197,26 @@ module Google
197
197
  universe_domain: @config.universe_domain,
198
198
  channel_args: @config.channel_args,
199
199
  interceptors: @config.interceptors,
200
- channel_pool_config: @config.channel_pool
200
+ channel_pool_config: @config.channel_pool,
201
+ logger: @config.logger
201
202
  )
202
203
 
204
+ @secret_manager_service_stub.stub_logger&.info do |entry|
205
+ entry.set_system_name
206
+ entry.set_service
207
+ entry.message = "Created client for #{entry.service}"
208
+ entry.set_credentials_fields credentials
209
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
210
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
211
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
212
+ end
213
+
203
214
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
204
215
  config.credentials = credentials
205
216
  config.quota_project = @quota_project_id
206
217
  config.endpoint = @secret_manager_service_stub.endpoint
207
218
  config.universe_domain = @secret_manager_service_stub.universe_domain
219
+ config.logger = @secret_manager_service_stub.logger if config.respond_to? :logger=
208
220
  end
209
221
  end
210
222
 
@@ -215,6 +227,15 @@ module Google
215
227
  #
216
228
  attr_reader :location_client
217
229
 
230
+ ##
231
+ # The logger used for request/response debug logging.
232
+ #
233
+ # @return [Logger]
234
+ #
235
+ def logger
236
+ @secret_manager_service_stub.logger
237
+ end
238
+
218
239
  # Service calls
219
240
 
220
241
  ##
@@ -317,7 +338,7 @@ module Google
317
338
  @secret_manager_service_stub.call_rpc :list_secrets, request, options: options do |response, operation|
318
339
  response = ::Gapic::PagedEnumerable.new @secret_manager_service_stub, :list_secrets, request, response, operation, options
319
340
  yield response, operation if block_given?
320
- return response
341
+ throw :response, response
321
342
  end
322
343
  rescue ::GRPC::BadStatus => e
323
344
  raise ::Google::Cloud::Error.from_error(e)
@@ -415,7 +436,6 @@ module Google
415
436
 
416
437
  @secret_manager_service_stub.call_rpc :create_secret, request, options: options do |response, operation|
417
438
  yield response, operation if block_given?
418
- return response
419
439
  end
420
440
  rescue ::GRPC::BadStatus => e
421
441
  raise ::Google::Cloud::Error.from_error(e)
@@ -509,7 +529,6 @@ module Google
509
529
 
510
530
  @secret_manager_service_stub.call_rpc :add_secret_version, request, options: options do |response, operation|
511
531
  yield response, operation if block_given?
512
- return response
513
532
  end
514
533
  rescue ::GRPC::BadStatus => e
515
534
  raise ::Google::Cloud::Error.from_error(e)
@@ -597,7 +616,6 @@ module Google
597
616
 
598
617
  @secret_manager_service_stub.call_rpc :get_secret, request, options: options do |response, operation|
599
618
  yield response, operation if block_given?
600
- return response
601
619
  end
602
620
  rescue ::GRPC::BadStatus => e
603
621
  raise ::Google::Cloud::Error.from_error(e)
@@ -687,7 +705,6 @@ module Google
687
705
 
688
706
  @secret_manager_service_stub.call_rpc :update_secret, request, options: options do |response, operation|
689
707
  yield response, operation if block_given?
690
- return response
691
708
  end
692
709
  rescue ::GRPC::BadStatus => e
693
710
  raise ::Google::Cloud::Error.from_error(e)
@@ -779,7 +796,6 @@ module Google
779
796
 
780
797
  @secret_manager_service_stub.call_rpc :delete_secret, request, options: options do |response, operation|
781
798
  yield response, operation if block_given?
782
- return response
783
799
  end
784
800
  rescue ::GRPC::BadStatus => e
785
801
  raise ::Google::Cloud::Error.from_error(e)
@@ -887,7 +903,7 @@ module Google
887
903
  @secret_manager_service_stub.call_rpc :list_secret_versions, request, options: options do |response, operation|
888
904
  response = ::Gapic::PagedEnumerable.new @secret_manager_service_stub, :list_secret_versions, request, response, operation, options
889
905
  yield response, operation if block_given?
890
- return response
906
+ throw :response, response
891
907
  end
892
908
  rescue ::GRPC::BadStatus => e
893
909
  raise ::Google::Cloud::Error.from_error(e)
@@ -985,7 +1001,6 @@ module Google
985
1001
 
986
1002
  @secret_manager_service_stub.call_rpc :get_secret_version, request, options: options do |response, operation|
987
1003
  yield response, operation if block_given?
988
- return response
989
1004
  end
990
1005
  rescue ::GRPC::BadStatus => e
991
1006
  raise ::Google::Cloud::Error.from_error(e)
@@ -1083,7 +1098,6 @@ module Google
1083
1098
 
1084
1099
  @secret_manager_service_stub.call_rpc :access_secret_version, request, options: options do |response, operation|
1085
1100
  yield response, operation if block_given?
1086
- return response
1087
1101
  end
1088
1102
  rescue ::GRPC::BadStatus => e
1089
1103
  raise ::Google::Cloud::Error.from_error(e)
@@ -1181,7 +1195,6 @@ module Google
1181
1195
 
1182
1196
  @secret_manager_service_stub.call_rpc :disable_secret_version, request, options: options do |response, operation|
1183
1197
  yield response, operation if block_given?
1184
- return response
1185
1198
  end
1186
1199
  rescue ::GRPC::BadStatus => e
1187
1200
  raise ::Google::Cloud::Error.from_error(e)
@@ -1279,7 +1292,6 @@ module Google
1279
1292
 
1280
1293
  @secret_manager_service_stub.call_rpc :enable_secret_version, request, options: options do |response, operation|
1281
1294
  yield response, operation if block_given?
1282
- return response
1283
1295
  end
1284
1296
  rescue ::GRPC::BadStatus => e
1285
1297
  raise ::Google::Cloud::Error.from_error(e)
@@ -1378,7 +1390,6 @@ module Google
1378
1390
 
1379
1391
  @secret_manager_service_stub.call_rpc :destroy_secret_version, request, options: options do |response, operation|
1380
1392
  yield response, operation if block_given?
1381
- return response
1382
1393
  end
1383
1394
  rescue ::GRPC::BadStatus => e
1384
1395
  raise ::Google::Cloud::Error.from_error(e)
@@ -1482,7 +1493,6 @@ module Google
1482
1493
 
1483
1494
  @secret_manager_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
1484
1495
  yield response, operation if block_given?
1485
- return response
1486
1496
  end
1487
1497
  rescue ::GRPC::BadStatus => e
1488
1498
  raise ::Google::Cloud::Error.from_error(e)
@@ -1573,7 +1583,6 @@ module Google
1573
1583
 
1574
1584
  @secret_manager_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
1575
1585
  yield response, operation if block_given?
1576
- return response
1577
1586
  end
1578
1587
  rescue ::GRPC::BadStatus => e
1579
1588
  raise ::Google::Cloud::Error.from_error(e)
@@ -1671,7 +1680,6 @@ module Google
1671
1680
 
1672
1681
  @secret_manager_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
1673
1682
  yield response, operation if block_given?
1674
- return response
1675
1683
  end
1676
1684
  rescue ::GRPC::BadStatus => e
1677
1685
  raise ::Google::Cloud::Error.from_error(e)
@@ -1760,6 +1768,11 @@ module Google
1760
1768
  # default endpoint URL. The default value of nil uses the environment
1761
1769
  # universe (usually the default "googleapis.com" universe).
1762
1770
  # @return [::String,nil]
1771
+ # @!attribute [rw] logger
1772
+ # A custom logger to use for request/response debug logging, or the value
1773
+ # `:default` (the default) to construct a default logger, or `nil` to
1774
+ # explicitly disable logging.
1775
+ # @return [::Logger,:default,nil]
1763
1776
  #
1764
1777
  class Configuration
1765
1778
  extend ::Gapic::Config
@@ -1784,6 +1797,7 @@ module Google
1784
1797
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1785
1798
  config_attr :quota_project, nil, ::String, nil
1786
1799
  config_attr :universe_domain, nil, ::String, nil
1800
+ config_attr :logger, :default, ::Logger, nil, :default
1787
1801
 
1788
1802
  # @private
1789
1803
  def initialize parent_config = nil
@@ -190,15 +190,27 @@ module Google
190
190
  endpoint: @config.endpoint,
191
191
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
192
192
  universe_domain: @config.universe_domain,
193
- credentials: credentials
193
+ credentials: credentials,
194
+ logger: @config.logger
194
195
  )
195
196
 
197
+ @secret_manager_service_stub.logger(stub: true)&.info do |entry|
198
+ entry.set_system_name
199
+ entry.set_service
200
+ entry.message = "Created client for #{entry.service}"
201
+ entry.set_credentials_fields credentials
202
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
203
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
204
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
205
+ end
206
+
196
207
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
197
208
  config.credentials = credentials
198
209
  config.quota_project = @quota_project_id
199
210
  config.endpoint = @secret_manager_service_stub.endpoint
200
211
  config.universe_domain = @secret_manager_service_stub.universe_domain
201
212
  config.bindings_override = @config.bindings_override
213
+ config.logger = @secret_manager_service_stub.logger if config.respond_to? :logger=
202
214
  end
203
215
  end
204
216
 
@@ -209,6 +221,15 @@ module Google
209
221
  #
210
222
  attr_reader :location_client
211
223
 
224
+ ##
225
+ # The logger used for request/response debug logging.
226
+ #
227
+ # @return [Logger]
228
+ #
229
+ def logger
230
+ @secret_manager_service_stub.logger
231
+ end
232
+
212
233
  # Service calls
213
234
 
214
235
  ##
@@ -304,7 +325,7 @@ module Google
304
325
  @secret_manager_service_stub.list_secrets request, options do |result, operation|
305
326
  result = ::Gapic::Rest::PagedEnumerable.new @secret_manager_service_stub, :list_secrets, "secrets", request, result, options
306
327
  yield result, operation if block_given?
307
- return result
328
+ throw :response, result
308
329
  end
309
330
  rescue ::Gapic::Rest::Error => e
310
331
  raise ::Google::Cloud::Error.from_error(e)
@@ -395,7 +416,6 @@ module Google
395
416
 
396
417
  @secret_manager_service_stub.create_secret request, options do |result, operation|
397
418
  yield result, operation if block_given?
398
- return result
399
419
  end
400
420
  rescue ::Gapic::Rest::Error => e
401
421
  raise ::Google::Cloud::Error.from_error(e)
@@ -482,7 +502,6 @@ module Google
482
502
 
483
503
  @secret_manager_service_stub.add_secret_version request, options do |result, operation|
484
504
  yield result, operation if block_given?
485
- return result
486
505
  end
487
506
  rescue ::Gapic::Rest::Error => e
488
507
  raise ::Google::Cloud::Error.from_error(e)
@@ -563,7 +582,6 @@ module Google
563
582
 
564
583
  @secret_manager_service_stub.get_secret request, options do |result, operation|
565
584
  yield result, operation if block_given?
566
- return result
567
585
  end
568
586
  rescue ::Gapic::Rest::Error => e
569
587
  raise ::Google::Cloud::Error.from_error(e)
@@ -646,7 +664,6 @@ module Google
646
664
 
647
665
  @secret_manager_service_stub.update_secret request, options do |result, operation|
648
666
  yield result, operation if block_given?
649
- return result
650
667
  end
651
668
  rescue ::Gapic::Rest::Error => e
652
669
  raise ::Google::Cloud::Error.from_error(e)
@@ -731,7 +748,6 @@ module Google
731
748
 
732
749
  @secret_manager_service_stub.delete_secret request, options do |result, operation|
733
750
  yield result, operation if block_given?
734
- return result
735
751
  end
736
752
  rescue ::Gapic::Rest::Error => e
737
753
  raise ::Google::Cloud::Error.from_error(e)
@@ -832,7 +848,7 @@ module Google
832
848
  @secret_manager_service_stub.list_secret_versions request, options do |result, operation|
833
849
  result = ::Gapic::Rest::PagedEnumerable.new @secret_manager_service_stub, :list_secret_versions, "versions", request, result, options
834
850
  yield result, operation if block_given?
835
- return result
851
+ throw :response, result
836
852
  end
837
853
  rescue ::Gapic::Rest::Error => e
838
854
  raise ::Google::Cloud::Error.from_error(e)
@@ -923,7 +939,6 @@ module Google
923
939
 
924
940
  @secret_manager_service_stub.get_secret_version request, options do |result, operation|
925
941
  yield result, operation if block_given?
926
- return result
927
942
  end
928
943
  rescue ::Gapic::Rest::Error => e
929
944
  raise ::Google::Cloud::Error.from_error(e)
@@ -1014,7 +1029,6 @@ module Google
1014
1029
 
1015
1030
  @secret_manager_service_stub.access_secret_version request, options do |result, operation|
1016
1031
  yield result, operation if block_given?
1017
- return result
1018
1032
  end
1019
1033
  rescue ::Gapic::Rest::Error => e
1020
1034
  raise ::Google::Cloud::Error.from_error(e)
@@ -1105,7 +1119,6 @@ module Google
1105
1119
 
1106
1120
  @secret_manager_service_stub.disable_secret_version request, options do |result, operation|
1107
1121
  yield result, operation if block_given?
1108
- return result
1109
1122
  end
1110
1123
  rescue ::Gapic::Rest::Error => e
1111
1124
  raise ::Google::Cloud::Error.from_error(e)
@@ -1196,7 +1209,6 @@ module Google
1196
1209
 
1197
1210
  @secret_manager_service_stub.enable_secret_version request, options do |result, operation|
1198
1211
  yield result, operation if block_given?
1199
- return result
1200
1212
  end
1201
1213
  rescue ::Gapic::Rest::Error => e
1202
1214
  raise ::Google::Cloud::Error.from_error(e)
@@ -1288,7 +1300,6 @@ module Google
1288
1300
 
1289
1301
  @secret_manager_service_stub.destroy_secret_version request, options do |result, operation|
1290
1302
  yield result, operation if block_given?
1291
- return result
1292
1303
  end
1293
1304
  rescue ::Gapic::Rest::Error => e
1294
1305
  raise ::Google::Cloud::Error.from_error(e)
@@ -1385,7 +1396,6 @@ module Google
1385
1396
 
1386
1397
  @secret_manager_service_stub.set_iam_policy request, options do |result, operation|
1387
1398
  yield result, operation if block_given?
1388
- return result
1389
1399
  end
1390
1400
  rescue ::Gapic::Rest::Error => e
1391
1401
  raise ::Google::Cloud::Error.from_error(e)
@@ -1469,7 +1479,6 @@ module Google
1469
1479
 
1470
1480
  @secret_manager_service_stub.get_iam_policy request, options do |result, operation|
1471
1481
  yield result, operation if block_given?
1472
- return result
1473
1482
  end
1474
1483
  rescue ::Gapic::Rest::Error => e
1475
1484
  raise ::Google::Cloud::Error.from_error(e)
@@ -1560,7 +1569,6 @@ module Google
1560
1569
 
1561
1570
  @secret_manager_service_stub.test_iam_permissions request, options do |result, operation|
1562
1571
  yield result, operation if block_given?
1563
- return result
1564
1572
  end
1565
1573
  rescue ::Gapic::Rest::Error => e
1566
1574
  raise ::Google::Cloud::Error.from_error(e)
@@ -1640,6 +1648,11 @@ module Google
1640
1648
  # default endpoint URL. The default value of nil uses the environment
1641
1649
  # universe (usually the default "googleapis.com" universe).
1642
1650
  # @return [::String,nil]
1651
+ # @!attribute [rw] logger
1652
+ # A custom logger to use for request/response debug logging, or the value
1653
+ # `:default` (the default) to construct a default logger, or `nil` to
1654
+ # explicitly disable logging.
1655
+ # @return [::Logger,:default,nil]
1643
1656
  #
1644
1657
  class Configuration
1645
1658
  extend ::Gapic::Config
@@ -1668,6 +1681,7 @@ module Google
1668
1681
  # by the host service.
1669
1682
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1670
1683
  config_attr :bindings_override, {}, ::Hash, nil
1684
+ config_attr :logger, :default, ::Logger, nil, :default
1671
1685
 
1672
1686
  # @private
1673
1687
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the list_secrets REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "list_secrets",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::SecretManager::V1::ListSecretsResponse.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "create_secret",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::SecretManager::V1::Secret.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "add_secret_version",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::SecretManager::V1::SecretVersion.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "get_secret",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::SecretManager::V1::Secret.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "update_secret",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Cloud::SecretManager::V1::Secret.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "delete_secret",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "list_secret_versions",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Cloud::SecretManager::V1::ListSecretVersionsResponse.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -353,16 +379,18 @@ module Google
353
379
 
354
380
  response = @client_stub.make_http_request(
355
381
  verb,
356
- uri: uri,
357
- body: body || "",
358
- params: query_string_params,
382
+ uri: uri,
383
+ body: body || "",
384
+ params: query_string_params,
385
+ method_name: "get_secret_version",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::SecretManager::V1::SecretVersion.decode_json response.body, ignore_unknown_fields: true
363
-
364
- yield result, operation if block_given?
365
- result
390
+ catch :response do
391
+ yield result, operation if block_given?
392
+ result
393
+ end
366
394
  end
367
395
 
368
396
  ##
@@ -391,16 +419,18 @@ module Google
391
419
 
392
420
  response = @client_stub.make_http_request(
393
421
  verb,
394
- uri: uri,
395
- body: body || "",
396
- params: query_string_params,
422
+ uri: uri,
423
+ body: body || "",
424
+ params: query_string_params,
425
+ method_name: "access_secret_version",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Cloud::SecretManager::V1::AccessSecretVersionResponse.decode_json response.body, ignore_unknown_fields: true
401
-
402
- yield result, operation if block_given?
403
- result
430
+ catch :response do
431
+ yield result, operation if block_given?
432
+ result
433
+ end
404
434
  end
405
435
 
406
436
  ##
@@ -429,16 +459,18 @@ module Google
429
459
 
430
460
  response = @client_stub.make_http_request(
431
461
  verb,
432
- uri: uri,
433
- body: body || "",
434
- params: query_string_params,
462
+ uri: uri,
463
+ body: body || "",
464
+ params: query_string_params,
465
+ method_name: "disable_secret_version",
435
466
  options: options
436
467
  )
437
468
  operation = ::Gapic::Rest::TransportOperation.new response
438
469
  result = ::Google::Cloud::SecretManager::V1::SecretVersion.decode_json response.body, ignore_unknown_fields: true
439
-
440
- yield result, operation if block_given?
441
- result
470
+ catch :response do
471
+ yield result, operation if block_given?
472
+ result
473
+ end
442
474
  end
443
475
 
444
476
  ##
@@ -467,16 +499,18 @@ module Google
467
499
 
468
500
  response = @client_stub.make_http_request(
469
501
  verb,
470
- uri: uri,
471
- body: body || "",
472
- params: query_string_params,
502
+ uri: uri,
503
+ body: body || "",
504
+ params: query_string_params,
505
+ method_name: "enable_secret_version",
473
506
  options: options
474
507
  )
475
508
  operation = ::Gapic::Rest::TransportOperation.new response
476
509
  result = ::Google::Cloud::SecretManager::V1::SecretVersion.decode_json response.body, ignore_unknown_fields: true
477
-
478
- yield result, operation if block_given?
479
- result
510
+ catch :response do
511
+ yield result, operation if block_given?
512
+ result
513
+ end
480
514
  end
481
515
 
482
516
  ##
@@ -505,16 +539,18 @@ module Google
505
539
 
506
540
  response = @client_stub.make_http_request(
507
541
  verb,
508
- uri: uri,
509
- body: body || "",
510
- params: query_string_params,
542
+ uri: uri,
543
+ body: body || "",
544
+ params: query_string_params,
545
+ method_name: "destroy_secret_version",
511
546
  options: options
512
547
  )
513
548
  operation = ::Gapic::Rest::TransportOperation.new response
514
549
  result = ::Google::Cloud::SecretManager::V1::SecretVersion.decode_json response.body, ignore_unknown_fields: true
515
-
516
- yield result, operation if block_given?
517
- result
550
+ catch :response do
551
+ yield result, operation if block_given?
552
+ result
553
+ end
518
554
  end
519
555
 
520
556
  ##
@@ -543,16 +579,18 @@ module Google
543
579
 
544
580
  response = @client_stub.make_http_request(
545
581
  verb,
546
- uri: uri,
547
- body: body || "",
548
- params: query_string_params,
582
+ uri: uri,
583
+ body: body || "",
584
+ params: query_string_params,
585
+ method_name: "set_iam_policy",
549
586
  options: options
550
587
  )
551
588
  operation = ::Gapic::Rest::TransportOperation.new response
552
589
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
553
-
554
- yield result, operation if block_given?
555
- result
590
+ catch :response do
591
+ yield result, operation if block_given?
592
+ result
593
+ end
556
594
  end
557
595
 
558
596
  ##
@@ -581,16 +619,18 @@ module Google
581
619
 
582
620
  response = @client_stub.make_http_request(
583
621
  verb,
584
- uri: uri,
585
- body: body || "",
586
- params: query_string_params,
622
+ uri: uri,
623
+ body: body || "",
624
+ params: query_string_params,
625
+ method_name: "get_iam_policy",
587
626
  options: options
588
627
  )
589
628
  operation = ::Gapic::Rest::TransportOperation.new response
590
629
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
591
-
592
- yield result, operation if block_given?
593
- result
630
+ catch :response do
631
+ yield result, operation if block_given?
632
+ result
633
+ end
594
634
  end
595
635
 
596
636
  ##
@@ -619,16 +659,18 @@ module Google
619
659
 
620
660
  response = @client_stub.make_http_request(
621
661
  verb,
622
- uri: uri,
623
- body: body || "",
624
- params: query_string_params,
662
+ uri: uri,
663
+ body: body || "",
664
+ params: query_string_params,
665
+ method_name: "test_iam_permissions",
625
666
  options: options
626
667
  )
627
668
  operation = ::Gapic::Rest::TransportOperation.new response
628
669
  result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
629
-
630
- yield result, operation if block_given?
631
- result
670
+ catch :response do
671
+ yield result, operation if block_given?
672
+ result
673
+ end
632
674
  end
633
675
 
634
676
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module SecretManager
23
23
  module V1
24
- VERSION = "1.0.0"
24
+ VERSION = "1.1.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,32 @@ module Google
196
199
  # @!attribute [rw] common
197
200
  # @return [::Google::Api::CommonLanguageSettings]
198
201
  # Some settings.
202
+ # @!attribute [rw] experimental_features
203
+ # @return [::Google::Api::PythonSettings::ExperimentalFeatures]
204
+ # Experimental features to be included during client library generation.
199
205
  class PythonSettings
200
206
  include ::Google::Protobuf::MessageExts
201
207
  extend ::Google::Protobuf::MessageExts::ClassMethods
208
+
209
+ # Experimental features to be included during client library generation.
210
+ # These fields will be deprecated once the feature graduates and is enabled
211
+ # by default.
212
+ # @!attribute [rw] rest_async_io_enabled
213
+ # @return [::Boolean]
214
+ # Enables generation of asynchronous REST clients if `rest` transport is
215
+ # enabled. By default, asynchronous REST clients will not be generated.
216
+ # This feature will be enabled by default 1 month after launching the
217
+ # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
224
+ class ExperimentalFeatures
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
202
228
  end
203
229
 
204
230
  # Settings for Node client libraries.
@@ -280,9 +306,28 @@ module Google
280
306
  # @!attribute [rw] common
281
307
  # @return [::Google::Api::CommonLanguageSettings]
282
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
283
319
  class GoSettings
284
320
  include ::Google::Protobuf::MessageExts
285
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
286
331
  end
287
332
 
288
333
  # Describes the generator configuration for a method.
@@ -290,6 +335,13 @@ module Google
290
335
  # @return [::String]
291
336
  # The fully qualified name of the method, for which the options below apply.
292
337
  # This is used to find the method to apply the options.
338
+ #
339
+ # Example:
340
+ #
341
+ # publishing:
342
+ # method_settings:
343
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
344
+ # # method settings for CreateFolder...
293
345
  # @!attribute [rw] long_running
294
346
  # @return [::Google::Api::MethodSettings::LongRunning]
295
347
  # Describes settings to use for long-running operations when generating
@@ -298,17 +350,14 @@ module Google
298
350
  #
299
351
  # Example of a YAML configuration::
300
352
  #
301
- # publishing:
302
- # method_settings:
353
+ # publishing:
354
+ # method_settings:
303
355
  # - selector: google.cloud.speech.v2.Speech.BatchRecognize
304
356
  # long_running:
305
- # initial_poll_delay:
306
- # seconds: 60 # 1 minute
357
+ # initial_poll_delay: 60s # 1 minute
307
358
  # poll_delay_multiplier: 1.5
308
- # max_poll_delay:
309
- # seconds: 360 # 6 minutes
310
- # total_poll_timeout:
311
- # seconds: 54000 # 90 minutes
359
+ # max_poll_delay: 360s # 6 minutes
360
+ # total_poll_timeout: 54000s # 90 minutes
312
361
  # @!attribute [rw] auto_populated_fields
313
362
  # @return [::Array<::String>]
314
363
  # List of top-level fields of the request message, that should be
@@ -317,8 +366,8 @@ module Google
317
366
  #
318
367
  # Example of a YAML configuration:
319
368
  #
320
- # publishing:
321
- # method_settings:
369
+ # publishing:
370
+ # method_settings:
322
371
  # - selector: google.example.v1.ExampleService.CreateExample
323
372
  # auto_populated_fields:
324
373
  # - request_id
@@ -354,6 +403,17 @@ module Google
354
403
  end
355
404
  end
356
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
357
417
  # The organization for which the client libraries are being published.
358
418
  # Affects the url where generated docs are published, etc.
359
419
  module ClientLibraryOrganization
@@ -124,8 +124,13 @@ module Google
124
124
  # @return [::String]
125
125
  # The plural name used in the resource name and permission names, such as
126
126
  # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
- # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
- # concept of the `plural` field in k8s CRD spec
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
128
+ # to this is for Nested Collections that have stuttering names, as defined
129
+ # in [AIP-122](https://google.aip.dev/122#nested-collections), where the
130
+ # collection ID in the resource name pattern does not necessarily directly
131
+ # match the `plural` value.
132
+ #
133
+ # It is the same concept of the `plural` field in k8s CRD spec
129
134
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
135
  #
131
136
  # Note: The plural form is required even for singleton resources. See
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-secret_manager-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.0
4
+ version: 1.1.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-07-08 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
@@ -142,7 +142,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
142
142
  - !ruby/object:Gem::Version
143
143
  version: '0'
144
144
  requirements: []
145
- rubygems_version: 3.5.6
145
+ rubygems_version: 3.5.23
146
146
  signing_key:
147
147
  specification_version: 4
148
148
  summary: Stores sensitive data such as API keys, passwords, and certificates. Provides