google-cloud-secret_manager-v1beta1 0.8.1 → 0.8.5

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: 120b24c53e537e8fbb709115e26753d1399aa0bfd41a83ee5844d33e8f6a4447
4
- data.tar.gz: db50eaba52c03956c3ee8d093a5b18aa2a1a6dfe065eb03bfb717481f0d249f1
3
+ metadata.gz: ad9bcdb2300bbbfff97a45f0d3f20ab6a37e9b05e818b6d34e89a7a97790699e
4
+ data.tar.gz: 5f6ea4dfd3ca11be1ec0efdcd6151d9020ec9b32725ce9700c4048ece00e4b89
5
5
  SHA512:
6
- metadata.gz: 697b567ba274a3c02f4ff2d3966e0ea18d8c30fc46ca4a1e790975dd0c9e299ced1ca9d93d7359504bf120a89d9d24e110bd4164d8fdf785b7496555a2f07f41
7
- data.tar.gz: aa879fe5342023a286d04344dd67263d1d81383afbf8af09ea11c46a6e00cd6e583b2c8a4d316a973d20c1efbcfe79c0ee152ae289d44516fc2d55d059ed4d01
6
+ metadata.gz: 04734c3a54ccd794021d41700fb09e0c28fd94ba301940616e17c81aa1e10717d0dcbce0d8f141202a3e6e41777e1d857acdbd4e63f49ac9690cd50c6ce01a90
7
+ data.tar.gz: f9fd30343175196561f129866b334672f809fb391a0ad9c303aa583392175d1718828874659d2b30d5a287ef677f06fe969ae42fac6e3f82972ae6c4da37e2b2
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Secret Manager V1beta1 API
2
+ --title="Secret Manager V1beta1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-secret_manager-v1beta1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Credentials}):
68
68
 
69
- 1. `SECRET_MANAGER_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `SECRET_MANAGER_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `SECRET_MANAGER_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `SECRET_MANAGER_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/secret_manager/v1beta1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.n
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/secret_manager/v1beta1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.n
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/secret_manager/v1beta1"
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/secret_manager/v1beta1"
34
34
 
35
35
  client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::SecretManager::V1beta1::ListSecretsRequest.new # (request fields as keyword arguments...)
37
37
  response = client.list_secrets request
38
38
  ```
39
39
 
@@ -47,13 +47,12 @@ module Google
47
47
  # See {::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client::Configuration}
48
48
  # for a description of the configuration fields.
49
49
  #
50
- # ## Example
50
+ # @example
51
51
  #
52
- # To modify the configuration for all SecretManagerService clients:
53
- #
54
- # ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.configure do |config|
55
- # config.timeout = 10.0
56
- # end
52
+ # # Modify the configuration for all SecretManagerService clients
53
+ # ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.configure do |config|
54
+ # config.timeout = 10.0
55
+ # end
57
56
  #
58
57
  # @yield [config] Configure the Client client.
59
58
  # @yieldparam config [Client::Configuration]
@@ -89,10 +88,7 @@ module Google
89
88
 
90
89
  default_config.rpcs.access_secret_version.timeout = 60.0
91
90
  default_config.rpcs.access_secret_version.retry_policy = {
92
- initial_delay: 1.0,
93
- max_delay: 60.0,
94
- multiplier: 1.3,
95
- retry_codes: [14, 2]
91
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 2]
96
92
  }
97
93
 
98
94
  default_config.rpcs.disable_secret_version.timeout = 60.0
@@ -136,19 +132,15 @@ module Google
136
132
  ##
137
133
  # Create a new SecretManagerService client object.
138
134
  #
139
- # ## Examples
140
- #
141
- # To create a new SecretManagerService client with the default
142
- # configuration:
135
+ # @example
143
136
  #
144
- # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
137
+ # # Create a client using the default configuration
138
+ # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
145
139
  #
146
- # To create a new SecretManagerService client with a custom
147
- # configuration:
148
- #
149
- # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new do |config|
150
- # config.timeout = 10.0
151
- # end
140
+ # # Create a client using a custom configuration
141
+ # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new do |config|
142
+ # config.timeout = 10.0
143
+ # end
152
144
  #
153
145
  # @yield [config] Configure the SecretManagerService client.
154
146
  # @yieldparam config [Client::Configuration]
@@ -168,14 +160,13 @@ module Google
168
160
 
169
161
  # Create credentials
170
162
  credentials = @config.credentials
171
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
163
+ # Use self-signed JWT if the endpoint is unchanged from default,
172
164
  # but only if the default endpoint does not have a region prefix.
173
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
174
- @config.endpoint == Client.configure.endpoint &&
165
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
175
166
  !@config.endpoint.split(".").first.include?("-")
176
167
  credentials ||= Credentials.default scope: @config.scope,
177
168
  enable_self_signed_jwt: enable_self_signed_jwt
178
- if credentials.is_a?(String) || credentials.is_a?(Hash)
169
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
179
170
  credentials = Credentials.new credentials, scope: @config.scope
180
171
  end
181
172
  @quota_project_id = @config.quota_project
@@ -229,6 +220,27 @@ module Google
229
220
  #
230
221
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
231
222
  #
223
+ # @example Basic example
224
+ # require "google/cloud/secret_manager/v1beta1"
225
+ #
226
+ # # Create a client object. The client can be reused for multiple calls.
227
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
228
+ #
229
+ # # Create a request. To set request fields, pass in keyword arguments.
230
+ # request = Google::Cloud::SecretManager::V1beta1::ListSecretsRequest.new
231
+ #
232
+ # # Call the list_secrets method.
233
+ # result = client.list_secrets request
234
+ #
235
+ # # The returned object is of type Gapic::PagedEnumerable. You can
236
+ # # iterate over all elements by calling #each, and the enumerable
237
+ # # will lazily make API calls to fetch subsequent pages. Other
238
+ # # methods are also available for managing paging directly.
239
+ # result.each do |response|
240
+ # # Each element is of type ::Google::Cloud::SecretManager::V1beta1::Secret.
241
+ # p response
242
+ # end
243
+ #
232
244
  def list_secrets request, options = nil
233
245
  raise ::ArgumentError, "request must be provided" if request.nil?
234
246
 
@@ -246,16 +258,20 @@ module Google
246
258
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
247
259
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
248
260
 
249
- header_params = {
250
- "parent" => request.parent
251
- }
261
+ header_params = {}
262
+ if request.parent
263
+ header_params["parent"] = request.parent
264
+ end
265
+
252
266
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
253
267
  metadata[:"x-goog-request-params"] ||= request_params_header
254
268
 
255
269
  options.apply_defaults timeout: @config.rpcs.list_secrets.timeout,
256
270
  metadata: metadata,
257
271
  retry_policy: @config.rpcs.list_secrets.retry_policy
258
- options.apply_defaults metadata: @config.metadata,
272
+
273
+ options.apply_defaults timeout: @config.timeout,
274
+ metadata: @config.metadata,
259
275
  retry_policy: @config.retry_policy
260
276
 
261
277
  @secret_manager_service_stub.call_rpc :list_secrets, request, options: options do |response, operation|
@@ -305,6 +321,21 @@ module Google
305
321
  #
306
322
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
307
323
  #
324
+ # @example Basic example
325
+ # require "google/cloud/secret_manager/v1beta1"
326
+ #
327
+ # # Create a client object. The client can be reused for multiple calls.
328
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
329
+ #
330
+ # # Create a request. To set request fields, pass in keyword arguments.
331
+ # request = Google::Cloud::SecretManager::V1beta1::CreateSecretRequest.new
332
+ #
333
+ # # Call the create_secret method.
334
+ # result = client.create_secret request
335
+ #
336
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::Secret.
337
+ # p result
338
+ #
308
339
  def create_secret request, options = nil
309
340
  raise ::ArgumentError, "request must be provided" if request.nil?
310
341
 
@@ -322,16 +353,20 @@ module Google
322
353
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
323
354
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
324
355
 
325
- header_params = {
326
- "parent" => request.parent
327
- }
356
+ header_params = {}
357
+ if request.parent
358
+ header_params["parent"] = request.parent
359
+ end
360
+
328
361
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
329
362
  metadata[:"x-goog-request-params"] ||= request_params_header
330
363
 
331
364
  options.apply_defaults timeout: @config.rpcs.create_secret.timeout,
332
365
  metadata: metadata,
333
366
  retry_policy: @config.rpcs.create_secret.retry_policy
334
- options.apply_defaults metadata: @config.metadata,
367
+
368
+ options.apply_defaults timeout: @config.timeout,
369
+ metadata: @config.metadata,
335
370
  retry_policy: @config.retry_policy
336
371
 
337
372
  @secret_manager_service_stub.call_rpc :create_secret, request, options: options do |response, operation|
@@ -375,6 +410,21 @@ module Google
375
410
  #
376
411
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
377
412
  #
413
+ # @example Basic example
414
+ # require "google/cloud/secret_manager/v1beta1"
415
+ #
416
+ # # Create a client object. The client can be reused for multiple calls.
417
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
418
+ #
419
+ # # Create a request. To set request fields, pass in keyword arguments.
420
+ # request = Google::Cloud::SecretManager::V1beta1::AddSecretVersionRequest.new
421
+ #
422
+ # # Call the add_secret_version method.
423
+ # result = client.add_secret_version request
424
+ #
425
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::SecretVersion.
426
+ # p result
427
+ #
378
428
  def add_secret_version request, options = nil
379
429
  raise ::ArgumentError, "request must be provided" if request.nil?
380
430
 
@@ -392,16 +442,20 @@ module Google
392
442
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
393
443
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
394
444
 
395
- header_params = {
396
- "parent" => request.parent
397
- }
445
+ header_params = {}
446
+ if request.parent
447
+ header_params["parent"] = request.parent
448
+ end
449
+
398
450
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
399
451
  metadata[:"x-goog-request-params"] ||= request_params_header
400
452
 
401
453
  options.apply_defaults timeout: @config.rpcs.add_secret_version.timeout,
402
454
  metadata: metadata,
403
455
  retry_policy: @config.rpcs.add_secret_version.retry_policy
404
- options.apply_defaults metadata: @config.metadata,
456
+
457
+ options.apply_defaults timeout: @config.timeout,
458
+ metadata: @config.metadata,
405
459
  retry_policy: @config.retry_policy
406
460
 
407
461
  @secret_manager_service_stub.call_rpc :add_secret_version, request, options: options do |response, operation|
@@ -441,6 +495,21 @@ module Google
441
495
  #
442
496
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
443
497
  #
498
+ # @example Basic example
499
+ # require "google/cloud/secret_manager/v1beta1"
500
+ #
501
+ # # Create a client object. The client can be reused for multiple calls.
502
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
503
+ #
504
+ # # Create a request. To set request fields, pass in keyword arguments.
505
+ # request = Google::Cloud::SecretManager::V1beta1::GetSecretRequest.new
506
+ #
507
+ # # Call the get_secret method.
508
+ # result = client.get_secret request
509
+ #
510
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::Secret.
511
+ # p result
512
+ #
444
513
  def get_secret request, options = nil
445
514
  raise ::ArgumentError, "request must be provided" if request.nil?
446
515
 
@@ -458,16 +527,20 @@ module Google
458
527
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
459
528
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
460
529
 
461
- header_params = {
462
- "name" => request.name
463
- }
530
+ header_params = {}
531
+ if request.name
532
+ header_params["name"] = request.name
533
+ end
534
+
464
535
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
465
536
  metadata[:"x-goog-request-params"] ||= request_params_header
466
537
 
467
538
  options.apply_defaults timeout: @config.rpcs.get_secret.timeout,
468
539
  metadata: metadata,
469
540
  retry_policy: @config.rpcs.get_secret.retry_policy
470
- options.apply_defaults metadata: @config.metadata,
541
+
542
+ options.apply_defaults timeout: @config.timeout,
543
+ metadata: @config.metadata,
471
544
  retry_policy: @config.retry_policy
472
545
 
473
546
  @secret_manager_service_stub.call_rpc :get_secret, request, options: options do |response, operation|
@@ -509,6 +582,21 @@ module Google
509
582
  #
510
583
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
511
584
  #
585
+ # @example Basic example
586
+ # require "google/cloud/secret_manager/v1beta1"
587
+ #
588
+ # # Create a client object. The client can be reused for multiple calls.
589
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
590
+ #
591
+ # # Create a request. To set request fields, pass in keyword arguments.
592
+ # request = Google::Cloud::SecretManager::V1beta1::UpdateSecretRequest.new
593
+ #
594
+ # # Call the update_secret method.
595
+ # result = client.update_secret request
596
+ #
597
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::Secret.
598
+ # p result
599
+ #
512
600
  def update_secret request, options = nil
513
601
  raise ::ArgumentError, "request must be provided" if request.nil?
514
602
 
@@ -526,16 +614,20 @@ module Google
526
614
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
527
615
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
528
616
 
529
- header_params = {
530
- "secret.name" => request.secret.name
531
- }
617
+ header_params = {}
618
+ if request.secret&.name
619
+ header_params["secret.name"] = request.secret.name
620
+ end
621
+
532
622
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
533
623
  metadata[:"x-goog-request-params"] ||= request_params_header
534
624
 
535
625
  options.apply_defaults timeout: @config.rpcs.update_secret.timeout,
536
626
  metadata: metadata,
537
627
  retry_policy: @config.rpcs.update_secret.retry_policy
538
- options.apply_defaults metadata: @config.metadata,
628
+
629
+ options.apply_defaults timeout: @config.timeout,
630
+ metadata: @config.metadata,
539
631
  retry_policy: @config.retry_policy
540
632
 
541
633
  @secret_manager_service_stub.call_rpc :update_secret, request, options: options do |response, operation|
@@ -576,6 +668,21 @@ module Google
576
668
  #
577
669
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
578
670
  #
671
+ # @example Basic example
672
+ # require "google/cloud/secret_manager/v1beta1"
673
+ #
674
+ # # Create a client object. The client can be reused for multiple calls.
675
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
676
+ #
677
+ # # Create a request. To set request fields, pass in keyword arguments.
678
+ # request = Google::Cloud::SecretManager::V1beta1::DeleteSecretRequest.new
679
+ #
680
+ # # Call the delete_secret method.
681
+ # result = client.delete_secret request
682
+ #
683
+ # # The returned object is of type Google::Protobuf::Empty.
684
+ # p result
685
+ #
579
686
  def delete_secret request, options = nil
580
687
  raise ::ArgumentError, "request must be provided" if request.nil?
581
688
 
@@ -593,16 +700,20 @@ module Google
593
700
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
594
701
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
595
702
 
596
- header_params = {
597
- "name" => request.name
598
- }
703
+ header_params = {}
704
+ if request.name
705
+ header_params["name"] = request.name
706
+ end
707
+
599
708
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
600
709
  metadata[:"x-goog-request-params"] ||= request_params_header
601
710
 
602
711
  options.apply_defaults timeout: @config.rpcs.delete_secret.timeout,
603
712
  metadata: metadata,
604
713
  retry_policy: @config.rpcs.delete_secret.retry_policy
605
- options.apply_defaults metadata: @config.metadata,
714
+
715
+ options.apply_defaults timeout: @config.timeout,
716
+ metadata: @config.metadata,
606
717
  retry_policy: @config.retry_policy
607
718
 
608
719
  @secret_manager_service_stub.call_rpc :delete_secret, request, options: options do |response, operation|
@@ -652,6 +763,27 @@ module Google
652
763
  #
653
764
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
654
765
  #
766
+ # @example Basic example
767
+ # require "google/cloud/secret_manager/v1beta1"
768
+ #
769
+ # # Create a client object. The client can be reused for multiple calls.
770
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
771
+ #
772
+ # # Create a request. To set request fields, pass in keyword arguments.
773
+ # request = Google::Cloud::SecretManager::V1beta1::ListSecretVersionsRequest.new
774
+ #
775
+ # # Call the list_secret_versions method.
776
+ # result = client.list_secret_versions request
777
+ #
778
+ # # The returned object is of type Gapic::PagedEnumerable. You can
779
+ # # iterate over all elements by calling #each, and the enumerable
780
+ # # will lazily make API calls to fetch subsequent pages. Other
781
+ # # methods are also available for managing paging directly.
782
+ # result.each do |response|
783
+ # # Each element is of type ::Google::Cloud::SecretManager::V1beta1::SecretVersion.
784
+ # p response
785
+ # end
786
+ #
655
787
  def list_secret_versions request, options = nil
656
788
  raise ::ArgumentError, "request must be provided" if request.nil?
657
789
 
@@ -669,16 +801,20 @@ module Google
669
801
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
670
802
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
671
803
 
672
- header_params = {
673
- "parent" => request.parent
674
- }
804
+ header_params = {}
805
+ if request.parent
806
+ header_params["parent"] = request.parent
807
+ end
808
+
675
809
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
676
810
  metadata[:"x-goog-request-params"] ||= request_params_header
677
811
 
678
812
  options.apply_defaults timeout: @config.rpcs.list_secret_versions.timeout,
679
813
  metadata: metadata,
680
814
  retry_policy: @config.rpcs.list_secret_versions.retry_policy
681
- options.apply_defaults metadata: @config.metadata,
815
+
816
+ options.apply_defaults timeout: @config.timeout,
817
+ metadata: @config.metadata,
682
818
  retry_policy: @config.retry_policy
683
819
 
684
820
  @secret_manager_service_stub.call_rpc :list_secret_versions, request, options: options do |response, operation|
@@ -725,6 +861,21 @@ module Google
725
861
  #
726
862
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
727
863
  #
864
+ # @example Basic example
865
+ # require "google/cloud/secret_manager/v1beta1"
866
+ #
867
+ # # Create a client object. The client can be reused for multiple calls.
868
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
869
+ #
870
+ # # Create a request. To set request fields, pass in keyword arguments.
871
+ # request = Google::Cloud::SecretManager::V1beta1::GetSecretVersionRequest.new
872
+ #
873
+ # # Call the get_secret_version method.
874
+ # result = client.get_secret_version request
875
+ #
876
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::SecretVersion.
877
+ # p result
878
+ #
728
879
  def get_secret_version request, options = nil
729
880
  raise ::ArgumentError, "request must be provided" if request.nil?
730
881
 
@@ -742,16 +893,20 @@ module Google
742
893
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
743
894
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
744
895
 
745
- header_params = {
746
- "name" => request.name
747
- }
896
+ header_params = {}
897
+ if request.name
898
+ header_params["name"] = request.name
899
+ end
900
+
748
901
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
749
902
  metadata[:"x-goog-request-params"] ||= request_params_header
750
903
 
751
904
  options.apply_defaults timeout: @config.rpcs.get_secret_version.timeout,
752
905
  metadata: metadata,
753
906
  retry_policy: @config.rpcs.get_secret_version.retry_policy
754
- options.apply_defaults metadata: @config.metadata,
907
+
908
+ options.apply_defaults timeout: @config.timeout,
909
+ metadata: @config.metadata,
755
910
  retry_policy: @config.retry_policy
756
911
 
757
912
  @secret_manager_service_stub.call_rpc :get_secret_version, request, options: options do |response, operation|
@@ -795,6 +950,21 @@ module Google
795
950
  #
796
951
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
797
952
  #
953
+ # @example Basic example
954
+ # require "google/cloud/secret_manager/v1beta1"
955
+ #
956
+ # # Create a client object. The client can be reused for multiple calls.
957
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
958
+ #
959
+ # # Create a request. To set request fields, pass in keyword arguments.
960
+ # request = Google::Cloud::SecretManager::V1beta1::AccessSecretVersionRequest.new
961
+ #
962
+ # # Call the access_secret_version method.
963
+ # result = client.access_secret_version request
964
+ #
965
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::AccessSecretVersionResponse.
966
+ # p result
967
+ #
798
968
  def access_secret_version request, options = nil
799
969
  raise ::ArgumentError, "request must be provided" if request.nil?
800
970
 
@@ -812,16 +982,20 @@ module Google
812
982
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
813
983
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
814
984
 
815
- header_params = {
816
- "name" => request.name
817
- }
985
+ header_params = {}
986
+ if request.name
987
+ header_params["name"] = request.name
988
+ end
989
+
818
990
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
819
991
  metadata[:"x-goog-request-params"] ||= request_params_header
820
992
 
821
993
  options.apply_defaults timeout: @config.rpcs.access_secret_version.timeout,
822
994
  metadata: metadata,
823
995
  retry_policy: @config.rpcs.access_secret_version.retry_policy
824
- options.apply_defaults metadata: @config.metadata,
996
+
997
+ options.apply_defaults timeout: @config.timeout,
998
+ metadata: @config.metadata,
825
999
  retry_policy: @config.retry_policy
826
1000
 
827
1001
  @secret_manager_service_stub.call_rpc :access_secret_version, request, options: options do |response, operation|
@@ -865,6 +1039,21 @@ module Google
865
1039
  #
866
1040
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
867
1041
  #
1042
+ # @example Basic example
1043
+ # require "google/cloud/secret_manager/v1beta1"
1044
+ #
1045
+ # # Create a client object. The client can be reused for multiple calls.
1046
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1047
+ #
1048
+ # # Create a request. To set request fields, pass in keyword arguments.
1049
+ # request = Google::Cloud::SecretManager::V1beta1::DisableSecretVersionRequest.new
1050
+ #
1051
+ # # Call the disable_secret_version method.
1052
+ # result = client.disable_secret_version request
1053
+ #
1054
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::SecretVersion.
1055
+ # p result
1056
+ #
868
1057
  def disable_secret_version request, options = nil
869
1058
  raise ::ArgumentError, "request must be provided" if request.nil?
870
1059
 
@@ -882,16 +1071,20 @@ module Google
882
1071
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
883
1072
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
884
1073
 
885
- header_params = {
886
- "name" => request.name
887
- }
1074
+ header_params = {}
1075
+ if request.name
1076
+ header_params["name"] = request.name
1077
+ end
1078
+
888
1079
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
889
1080
  metadata[:"x-goog-request-params"] ||= request_params_header
890
1081
 
891
1082
  options.apply_defaults timeout: @config.rpcs.disable_secret_version.timeout,
892
1083
  metadata: metadata,
893
1084
  retry_policy: @config.rpcs.disable_secret_version.retry_policy
894
- options.apply_defaults metadata: @config.metadata,
1085
+
1086
+ options.apply_defaults timeout: @config.timeout,
1087
+ metadata: @config.metadata,
895
1088
  retry_policy: @config.retry_policy
896
1089
 
897
1090
  @secret_manager_service_stub.call_rpc :disable_secret_version, request, options: options do |response, operation|
@@ -935,6 +1128,21 @@ module Google
935
1128
  #
936
1129
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
937
1130
  #
1131
+ # @example Basic example
1132
+ # require "google/cloud/secret_manager/v1beta1"
1133
+ #
1134
+ # # Create a client object. The client can be reused for multiple calls.
1135
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1136
+ #
1137
+ # # Create a request. To set request fields, pass in keyword arguments.
1138
+ # request = Google::Cloud::SecretManager::V1beta1::EnableSecretVersionRequest.new
1139
+ #
1140
+ # # Call the enable_secret_version method.
1141
+ # result = client.enable_secret_version request
1142
+ #
1143
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::SecretVersion.
1144
+ # p result
1145
+ #
938
1146
  def enable_secret_version request, options = nil
939
1147
  raise ::ArgumentError, "request must be provided" if request.nil?
940
1148
 
@@ -952,16 +1160,20 @@ module Google
952
1160
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
953
1161
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
954
1162
 
955
- header_params = {
956
- "name" => request.name
957
- }
1163
+ header_params = {}
1164
+ if request.name
1165
+ header_params["name"] = request.name
1166
+ end
1167
+
958
1168
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
959
1169
  metadata[:"x-goog-request-params"] ||= request_params_header
960
1170
 
961
1171
  options.apply_defaults timeout: @config.rpcs.enable_secret_version.timeout,
962
1172
  metadata: metadata,
963
1173
  retry_policy: @config.rpcs.enable_secret_version.retry_policy
964
- options.apply_defaults metadata: @config.metadata,
1174
+
1175
+ options.apply_defaults timeout: @config.timeout,
1176
+ metadata: @config.metadata,
965
1177
  retry_policy: @config.retry_policy
966
1178
 
967
1179
  @secret_manager_service_stub.call_rpc :enable_secret_version, request, options: options do |response, operation|
@@ -1006,6 +1218,21 @@ module Google
1006
1218
  #
1007
1219
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1008
1220
  #
1221
+ # @example Basic example
1222
+ # require "google/cloud/secret_manager/v1beta1"
1223
+ #
1224
+ # # Create a client object. The client can be reused for multiple calls.
1225
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1226
+ #
1227
+ # # Create a request. To set request fields, pass in keyword arguments.
1228
+ # request = Google::Cloud::SecretManager::V1beta1::DestroySecretVersionRequest.new
1229
+ #
1230
+ # # Call the destroy_secret_version method.
1231
+ # result = client.destroy_secret_version request
1232
+ #
1233
+ # # The returned object is of type Google::Cloud::SecretManager::V1beta1::SecretVersion.
1234
+ # p result
1235
+ #
1009
1236
  def destroy_secret_version request, options = nil
1010
1237
  raise ::ArgumentError, "request must be provided" if request.nil?
1011
1238
 
@@ -1023,16 +1250,20 @@ module Google
1023
1250
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
1024
1251
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1025
1252
 
1026
- header_params = {
1027
- "name" => request.name
1028
- }
1253
+ header_params = {}
1254
+ if request.name
1255
+ header_params["name"] = request.name
1256
+ end
1257
+
1029
1258
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1030
1259
  metadata[:"x-goog-request-params"] ||= request_params_header
1031
1260
 
1032
1261
  options.apply_defaults timeout: @config.rpcs.destroy_secret_version.timeout,
1033
1262
  metadata: metadata,
1034
1263
  retry_policy: @config.rpcs.destroy_secret_version.retry_policy
1035
- options.apply_defaults metadata: @config.metadata,
1264
+
1265
+ options.apply_defaults timeout: @config.timeout,
1266
+ metadata: @config.metadata,
1036
1267
  retry_policy: @config.retry_policy
1037
1268
 
1038
1269
  @secret_manager_service_stub.call_rpc :destroy_secret_version, request, options: options do |response, operation|
@@ -1082,6 +1313,21 @@ module Google
1082
1313
  #
1083
1314
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1084
1315
  #
1316
+ # @example Basic example
1317
+ # require "google/cloud/secret_manager/v1beta1"
1318
+ #
1319
+ # # Create a client object. The client can be reused for multiple calls.
1320
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1321
+ #
1322
+ # # Create a request. To set request fields, pass in keyword arguments.
1323
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
1324
+ #
1325
+ # # Call the set_iam_policy method.
1326
+ # result = client.set_iam_policy request
1327
+ #
1328
+ # # The returned object is of type Google::Iam::V1::Policy.
1329
+ # p result
1330
+ #
1085
1331
  def set_iam_policy request, options = nil
1086
1332
  raise ::ArgumentError, "request must be provided" if request.nil?
1087
1333
 
@@ -1099,16 +1345,20 @@ module Google
1099
1345
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
1100
1346
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1101
1347
 
1102
- header_params = {
1103
- "resource" => request.resource
1104
- }
1348
+ header_params = {}
1349
+ if request.resource
1350
+ header_params["resource"] = request.resource
1351
+ end
1352
+
1105
1353
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1106
1354
  metadata[:"x-goog-request-params"] ||= request_params_header
1107
1355
 
1108
1356
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
1109
1357
  metadata: metadata,
1110
1358
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
1111
- options.apply_defaults metadata: @config.metadata,
1359
+
1360
+ options.apply_defaults timeout: @config.timeout,
1361
+ metadata: @config.metadata,
1112
1362
  retry_policy: @config.retry_policy
1113
1363
 
1114
1364
  @secret_manager_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -1153,6 +1403,21 @@ module Google
1153
1403
  #
1154
1404
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1155
1405
  #
1406
+ # @example Basic example
1407
+ # require "google/cloud/secret_manager/v1beta1"
1408
+ #
1409
+ # # Create a client object. The client can be reused for multiple calls.
1410
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1411
+ #
1412
+ # # Create a request. To set request fields, pass in keyword arguments.
1413
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
1414
+ #
1415
+ # # Call the get_iam_policy method.
1416
+ # result = client.get_iam_policy request
1417
+ #
1418
+ # # The returned object is of type Google::Iam::V1::Policy.
1419
+ # p result
1420
+ #
1156
1421
  def get_iam_policy request, options = nil
1157
1422
  raise ::ArgumentError, "request must be provided" if request.nil?
1158
1423
 
@@ -1170,16 +1435,20 @@ module Google
1170
1435
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
1171
1436
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1172
1437
 
1173
- header_params = {
1174
- "resource" => request.resource
1175
- }
1438
+ header_params = {}
1439
+ if request.resource
1440
+ header_params["resource"] = request.resource
1441
+ end
1442
+
1176
1443
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1177
1444
  metadata[:"x-goog-request-params"] ||= request_params_header
1178
1445
 
1179
1446
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
1180
1447
  metadata: metadata,
1181
1448
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
1182
- options.apply_defaults metadata: @config.metadata,
1449
+
1450
+ options.apply_defaults timeout: @config.timeout,
1451
+ metadata: @config.metadata,
1183
1452
  retry_policy: @config.retry_policy
1184
1453
 
1185
1454
  @secret_manager_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -1231,6 +1500,21 @@ module Google
1231
1500
  #
1232
1501
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1233
1502
  #
1503
+ # @example Basic example
1504
+ # require "google/cloud/secret_manager/v1beta1"
1505
+ #
1506
+ # # Create a client object. The client can be reused for multiple calls.
1507
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
1508
+ #
1509
+ # # Create a request. To set request fields, pass in keyword arguments.
1510
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
1511
+ #
1512
+ # # Call the test_iam_permissions method.
1513
+ # result = client.test_iam_permissions request
1514
+ #
1515
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
1516
+ # p result
1517
+ #
1234
1518
  def test_iam_permissions request, options = nil
1235
1519
  raise ::ArgumentError, "request must be provided" if request.nil?
1236
1520
 
@@ -1248,16 +1532,20 @@ module Google
1248
1532
  gapic_version: ::Google::Cloud::SecretManager::V1beta1::VERSION
1249
1533
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1250
1534
 
1251
- header_params = {
1252
- "resource" => request.resource
1253
- }
1535
+ header_params = {}
1536
+ if request.resource
1537
+ header_params["resource"] = request.resource
1538
+ end
1539
+
1254
1540
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1255
1541
  metadata[:"x-goog-request-params"] ||= request_params_header
1256
1542
 
1257
1543
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
1258
1544
  metadata: metadata,
1259
1545
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
1260
- options.apply_defaults metadata: @config.metadata,
1546
+
1547
+ options.apply_defaults timeout: @config.timeout,
1548
+ metadata: @config.metadata,
1261
1549
  retry_policy: @config.retry_policy
1262
1550
 
1263
1551
  @secret_manager_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -1281,22 +1569,21 @@ module Google
1281
1569
  # Configuration can be applied globally to all clients, or to a single client
1282
1570
  # on construction.
1283
1571
  #
1284
- # # Examples
1285
- #
1286
- # To modify the global config, setting the timeout for list_secrets
1287
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1288
- #
1289
- # ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.configure do |config|
1290
- # config.timeout = 10.0
1291
- # config.rpcs.list_secrets.timeout = 20.0
1292
- # end
1293
- #
1294
- # To apply the above configuration only to a new client:
1295
- #
1296
- # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new do |config|
1297
- # config.timeout = 10.0
1298
- # config.rpcs.list_secrets.timeout = 20.0
1299
- # end
1572
+ # @example
1573
+ #
1574
+ # # Modify the global config, setting the timeout for
1575
+ # # list_secrets to 20 seconds,
1576
+ # # and all remaining timeouts to 10 seconds.
1577
+ # ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.configure do |config|
1578
+ # config.timeout = 10.0
1579
+ # config.rpcs.list_secrets.timeout = 20.0
1580
+ # end
1581
+ #
1582
+ # # Apply the above configuration only to a new client.
1583
+ # client = ::Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new do |config|
1584
+ # config.timeout = 10.0
1585
+ # config.rpcs.list_secrets.timeout = 20.0
1586
+ # end
1300
1587
  #
1301
1588
  # @!attribute [rw] endpoint
1302
1589
  # The hostname or hostname:port of the service endpoint.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module SecretManager
23
23
  module V1beta1
24
- VERSION = "0.8.1"
24
+ VERSION = "0.8.5"
25
25
  end
26
26
  end
27
27
  end
@@ -1,12 +1,12 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/secrets/v1beta1/resources.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/field_behavior_pb'
7
5
  require 'google/api/resource_pb'
8
6
  require 'google/protobuf/timestamp_pb'
9
7
  require 'google/api/annotations_pb'
8
+ require 'google/protobuf'
9
+
10
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
11
11
  add_file("google/cloud/secrets/v1beta1/resources.proto", :syntax => :proto3) do
12
12
  add_message "google.cloud.secrets.v1beta1.Secret" do
@@ -1,8 +1,6 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/secrets/v1beta1/service.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
@@ -12,6 +10,8 @@ require 'google/iam/v1/iam_policy_pb'
12
10
  require 'google/iam/v1/policy_pb'
13
11
  require 'google/protobuf/empty_pb'
14
12
  require 'google/protobuf/field_mask_pb'
13
+ require 'google/protobuf'
14
+
15
15
  Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  add_file("google/cloud/secrets/v1beta1/service.proto", :syntax => :proto3) do
17
17
  add_message "google.cloud.secrets.v1beta1.ListSecretsRequest" do
@@ -57,9 +57,15 @@ module Google
57
57
 
58
58
  # Denotes that a (repeated) field is an unordered list.
59
59
  # This indicates that the service may provide the elements of the list
60
- # in any arbitrary order, rather than the order the user originally
60
+ # in any arbitrary order, rather than the order the user originally
61
61
  # provided. Additionally, the list's order may or may not be stable.
62
62
  UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
63
69
  end
64
70
  end
65
71
  end
@@ -33,11 +33,7 @@ module Google
33
33
  # // For Kubernetes resources, the format is {api group}/{kind}.
34
34
  # option (google.api.resource) = {
35
35
  # type: "pubsub.googleapis.com/Topic"
36
- # name_descriptor: {
37
- # pattern: "projects/{project}/topics/{topic}"
38
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
39
- # parent_name_extractor: "projects/{project}"
40
- # }
36
+ # pattern: "projects/{project}/topics/{topic}"
41
37
  # };
42
38
  # }
43
39
  #
@@ -45,10 +41,7 @@ module Google
45
41
  #
46
42
  # resources:
47
43
  # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/{project}/topics/{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/{project}"
44
+ # pattern: "projects/{project}/topics/{topic}"
52
45
  #
53
46
  # Sometimes, resources have multiple patterns, typically because they can
54
47
  # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
58
51
  # message LogEntry {
59
52
  # option (google.api.resource) = {
60
53
  # type: "logging.googleapis.com/LogEntry"
61
- # name_descriptor: {
62
- # pattern: "projects/{project}/logs/{log}"
63
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
64
- # parent_name_extractor: "projects/{project}"
65
- # }
66
- # name_descriptor: {
67
- # pattern: "folders/{folder}/logs/{log}"
68
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
69
- # parent_name_extractor: "folders/{folder}"
70
- # }
71
- # name_descriptor: {
72
- # pattern: "organizations/{organization}/logs/{log}"
73
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
74
- # parent_name_extractor: "organizations/{organization}"
75
- # }
76
- # name_descriptor: {
77
- # pattern: "billingAccounts/{billing_account}/logs/{log}"
78
- # parent_type: "billing.googleapis.com/BillingAccount"
79
- # parent_name_extractor: "billingAccounts/{billing_account}"
80
- # }
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
81
58
  # };
82
59
  # }
83
60
  #
@@ -85,48 +62,10 @@ module Google
85
62
  #
86
63
  # resources:
87
64
  # - type: 'logging.googleapis.com/LogEntry'
88
- # name_descriptor:
89
- # - pattern: "projects/{project}/logs/{log}"
90
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
91
- # parent_name_extractor: "projects/{project}"
92
- # - pattern: "folders/{folder}/logs/{log}"
93
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
94
- # parent_name_extractor: "folders/{folder}"
95
- # - pattern: "organizations/{organization}/logs/{log}"
96
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
97
- # parent_name_extractor: "organizations/{organization}"
98
- # - pattern: "billingAccounts/{billing_account}/logs/{log}"
99
- # parent_type: "billing.googleapis.com/BillingAccount"
100
- # parent_name_extractor: "billingAccounts/{billing_account}"
101
- #
102
- # For flexible resources, the resource name doesn't contain parent names, but
103
- # the resource itself has parents for policy evaluation.
104
- #
105
- # Example:
106
- #
107
- # message Shelf {
108
- # option (google.api.resource) = {
109
- # type: "library.googleapis.com/Shelf"
110
- # name_descriptor: {
111
- # pattern: "shelves/{shelf}"
112
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
113
- # }
114
- # name_descriptor: {
115
- # pattern: "shelves/{shelf}"
116
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
117
- # }
118
- # };
119
- # }
120
- #
121
- # The ResourceDescriptor Yaml config will look like:
122
- #
123
- # resources:
124
- # - type: 'library.googleapis.com/Shelf'
125
- # name_descriptor:
126
- # - pattern: "shelves/{shelf}"
127
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
128
- # - pattern: "shelves/{shelf}"
129
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
130
69
  # @!attribute [rw] type
131
70
  # @return [::String]
132
71
  # The resource type. It must be in the format of
@@ -19,30 +19,53 @@
19
19
 
20
20
  module Google
21
21
  module Type
22
- # Represents an expression text. Example:
22
+ # Represents a textual expression in the Common Expression Language (CEL)
23
+ # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
24
+ # are documented at https://github.com/google/cel-spec.
23
25
  #
24
- # title: "User account presence"
25
- # description: "Determines whether the request has a user account"
26
- # expression: "size(request.user) > 0"
26
+ # Example (Comparison):
27
+ #
28
+ # title: "Summary size limit"
29
+ # description: "Determines if a summary is less than 100 chars"
30
+ # expression: "document.summary.size() < 100"
31
+ #
32
+ # Example (Equality):
33
+ #
34
+ # title: "Requestor is owner"
35
+ # description: "Determines if requestor is the document owner"
36
+ # expression: "document.owner == request.auth.claims.email"
37
+ #
38
+ # Example (Logic):
39
+ #
40
+ # title: "Public documents"
41
+ # description: "Determine whether the document should be publicly visible"
42
+ # expression: "document.type != 'private' && document.type != 'internal'"
43
+ #
44
+ # Example (Data Manipulation):
45
+ #
46
+ # title: "Notification string"
47
+ # description: "Create a notification string with a timestamp."
48
+ # expression: "'New message received at ' + string(document.create_time)"
49
+ #
50
+ # The exact variables and functions that may be referenced within an expression
51
+ # are determined by the service that evaluates it. See the service
52
+ # documentation for additional information.
27
53
  # @!attribute [rw] expression
28
54
  # @return [::String]
29
- # Textual representation of an expression in
30
- # Common Expression Language syntax.
31
- #
32
- # The application context of the containing message determines which
33
- # well-known feature set of CEL is supported.
55
+ # Textual representation of an expression in Common Expression Language
56
+ # syntax.
34
57
  # @!attribute [rw] title
35
58
  # @return [::String]
36
- # An optional title for the expression, i.e. a short string describing
59
+ # Optional. Title for the expression, i.e. a short string describing
37
60
  # its purpose. This can be used e.g. in UIs which allow to enter the
38
61
  # expression.
39
62
  # @!attribute [rw] description
40
63
  # @return [::String]
41
- # An optional description of the expression. This is a longer text which
64
+ # Optional. Description of the expression. This is a longer text which
42
65
  # describes the expression, e.g. when hovered over it in a UI.
43
66
  # @!attribute [rw] location
44
67
  # @return [::String]
45
- # An optional string indicating the location of the expression for error
68
+ # Optional. String indicating the location of the expression for error
46
69
  # reporting, e.g. a file name and a position in the file.
47
70
  class Expr
48
71
  include ::Google::Protobuf::MessageExts
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-secret_manager-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.8.1
4
+ version: 0.8.5
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-06-17 00:00:00.000000000 Z
11
+ date: 2022-01-11 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.5'
19
+ version: '0.7'
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.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -232,7 +232,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
232
232
  - !ruby/object:Gem::Version
233
233
  version: '0'
234
234
  requirements: []
235
- rubygems_version: 3.2.17
235
+ rubygems_version: 3.3.4
236
236
  signing_key:
237
237
  specification_version: 4
238
238
  summary: API Client library for the Secret Manager V1beta1 API