google-cloud-secret_manager-v1 1.0.0 → 1.1.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: 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