google-cloud-secret_manager-v1beta1 0.4.1 → 0.5.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: 61eca71488f024944bf51673d46d37f46547206c0b0bac1bbc4347a4824c2b13
4
- data.tar.gz: c36ba24a00a7f7852a6649823071eae245f907b88b17dc367fc92073370dce5b
3
+ metadata.gz: cedd1bc12854ce0a61d41f303eec6b7a87a17b5410f42b3e547d3e521c01bec9
4
+ data.tar.gz: b21c6a8db3ed700dbff1c348832712e1dbb5e0daaa038e9c8881ef6f474334ff
5
5
  SHA512:
6
- metadata.gz: 07fb61339ce90e71e1405c549526db6e0911b32ecb78842c16a5b482cd7ee216c3fd82d5cf8b628cfd752abfa5e411b6ed8654cf89bd23e13c5a67ef4ac40d28
7
- data.tar.gz: b30ecf57661ef0211bbeb6b0ee10e3cc4d1bcc47abfd38915d2367fb312ad7d414203124203f8eadf90f9cd01ffa5a27e9d638b56915acd6060dd89588438c93
6
+ metadata.gz: 8e1e4019b2f1e7aad52fac6fcdf4bc15091acc0130ab3abc67fc503363f0279071466e0b605125cc4aac1529f32040100b248d21c07405b3a652d7c60b3122bf
7
+ data.tar.gz: 50c5fbc5bfbcd7e3d8d119e279d60fba3f1a75c98c3601f2db6f4d80019f434379b5172310191b96a1ab9ceac0d1358d5f9c4abaa9d8b54cf59453ccbf20b621
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Secret Manager V1beta1
1
+ # Ruby Client for the Secret Manager V1beta1 API
2
2
 
3
3
  API Client library for the Secret Manager V1beta1 API
4
4
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
12
12
  $ gem install google-cloud-secret_manager-v1beta1
13
13
  ```
14
14
 
15
+ ## Before You Begin
16
+
17
+ In order to use this library, you first need to go through the following steps:
18
+
19
+ 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
20
+ 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
21
+ 1. {file:AUTHENTICATION.md Set up authentication.}
22
+
23
+ ## Quick Start
24
+
25
+ ```ruby
26
+ require "google/cloud/secret_manager/v1beta1"
27
+
28
+ client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
29
+ request = my_create_request
30
+ response = client.list_secrets request
31
+ ```
32
+
33
+ View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-secret_manager-v1beta1/latest)
34
+ for class and method documentation.
35
+
36
+ ## Enabling Logging
37
+
38
+ To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
39
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
40
+ or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
41
+ 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)
42
+ and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
43
+
44
+ Configuring a Ruby stdlib logger:
45
+
46
+ ```ruby
47
+ require "logger"
48
+
49
+ module MyLogger
50
+ LOGGER = Logger.new $stderr, level: Logger::WARN
51
+ def logger
52
+ LOGGER
53
+ end
54
+ end
55
+
56
+ # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
57
+ module GRPC
58
+ extend MyLogger
59
+ end
60
+ ```
61
+
15
62
  ## Supported Ruby Versions
16
63
 
17
64
  This library is supported on Ruby 2.4+.
@@ -16,15 +16,8 @@
16
16
 
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
- require "gapic/common"
20
- require "gapic/config"
21
- require "gapic/config/method"
22
-
23
19
  require "google/cloud/errors"
24
- require "google/cloud/secret_manager/v1beta1/version"
25
20
  require "google/cloud/secrets/v1beta1/service_pb"
26
- require "google/cloud/secret_manager/v1beta1/secret_manager_service/credentials"
27
- require "google/cloud/secret_manager/v1beta1/secret_manager_service/paths"
28
21
 
29
22
  module Google
30
23
  module Cloud
@@ -196,12 +189,20 @@ module Google
196
189
  # Lists {Google::Cloud::SecretManager::V1beta1::Secret Secrets}.
197
190
  #
198
191
  # @overload list_secrets(request, options = nil)
199
- # @param request [Google::Cloud::SecretManager::V1beta1::ListSecretsRequest | Hash]
200
- # Lists {Google::Cloud::SecretManager::V1beta1::Secret Secrets}.
192
+ # Pass arguments to `list_secrets` via a request object, either of type
193
+ # {Google::Cloud::SecretManager::V1beta1::ListSecretsRequest} or an equivalent Hash.
194
+ #
195
+ # @param request [Google::Cloud::SecretManager::V1beta1::ListSecretsRequest, Hash]
196
+ # A request object representing the call parameters. Required. To specify no
197
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
201
198
  # @param options [Gapic::CallOptions, Hash]
202
199
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
203
200
  #
204
201
  # @overload list_secrets(parent: nil, page_size: nil, page_token: nil)
202
+ # Pass arguments to `list_secrets` via keyword arguments. Note that at
203
+ # least one keyword argument is required. To specify no parameters, or to keep all
204
+ # the default parameter values, pass an empty Hash as a request object (see above).
205
+ #
205
206
  # @param parent [String]
206
207
  # Required. The resource name of the project associated with the
207
208
  # {Google::Cloud::SecretManager::V1beta1::Secret Secrets}, in the format `projects/*`.
@@ -213,7 +214,6 @@ module Google
213
214
  # Optional. Pagination token, returned earlier via
214
215
  # {Google::Cloud::SecretManager::V1beta1::ListSecretsResponse#next_page_token ListSecretsResponse.next_page_token}.
215
216
  #
216
- #
217
217
  # @yield [response, operation] Access the result along with the RPC operation
218
218
  # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::SecretManager::V1beta1::Secret>]
219
219
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -264,12 +264,20 @@ module Google
264
264
  # Creates a new {Google::Cloud::SecretManager::V1beta1::Secret Secret} containing no {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersions}.
265
265
  #
266
266
  # @overload create_secret(request, options = nil)
267
- # @param request [Google::Cloud::SecretManager::V1beta1::CreateSecretRequest | Hash]
268
- # Creates a new {Google::Cloud::SecretManager::V1beta1::Secret Secret} containing no {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersions}.
267
+ # Pass arguments to `create_secret` via a request object, either of type
268
+ # {Google::Cloud::SecretManager::V1beta1::CreateSecretRequest} or an equivalent Hash.
269
+ #
270
+ # @param request [Google::Cloud::SecretManager::V1beta1::CreateSecretRequest, Hash]
271
+ # A request object representing the call parameters. Required. To specify no
272
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
269
273
  # @param options [Gapic::CallOptions, Hash]
270
274
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
271
275
  #
272
276
  # @overload create_secret(parent: nil, secret_id: nil, secret: nil)
277
+ # Pass arguments to `create_secret` via keyword arguments. Note that at
278
+ # least one keyword argument is required. To specify no parameters, or to keep all
279
+ # the default parameter values, pass an empty Hash as a request object (see above).
280
+ #
273
281
  # @param parent [String]
274
282
  # Required. The resource name of the project to associate with the
275
283
  # {Google::Cloud::SecretManager::V1beta1::Secret Secret}, in the format `projects/*`.
@@ -279,10 +287,9 @@ module Google
279
287
  # A secret ID is a string with a maximum length of 255 characters and can
280
288
  # contain uppercase and lowercase letters, numerals, and the hyphen (`-`) and
281
289
  # underscore (`_`) characters.
282
- # @param secret [Google::Cloud::SecretManager::V1beta1::Secret | Hash]
290
+ # @param secret [Google::Cloud::SecretManager::V1beta1::Secret, Hash]
283
291
  # A {Google::Cloud::SecretManager::V1beta1::Secret Secret} with initial field values.
284
292
  #
285
- #
286
293
  # @yield [response, operation] Access the result along with the RPC operation
287
294
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::Secret]
288
295
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -333,20 +340,26 @@ module Google
333
340
  # it to an existing {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
334
341
  #
335
342
  # @overload add_secret_version(request, options = nil)
336
- # @param request [Google::Cloud::SecretManager::V1beta1::AddSecretVersionRequest | Hash]
337
- # Creates a new {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} containing secret data and attaches
338
- # it to an existing {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
343
+ # Pass arguments to `add_secret_version` via a request object, either of type
344
+ # {Google::Cloud::SecretManager::V1beta1::AddSecretVersionRequest} or an equivalent Hash.
345
+ #
346
+ # @param request [Google::Cloud::SecretManager::V1beta1::AddSecretVersionRequest, Hash]
347
+ # A request object representing the call parameters. Required. To specify no
348
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
339
349
  # @param options [Gapic::CallOptions, Hash]
340
350
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
341
351
  #
342
352
  # @overload add_secret_version(parent: nil, payload: nil)
353
+ # Pass arguments to `add_secret_version` via keyword arguments. Note that at
354
+ # least one keyword argument is required. To specify no parameters, or to keep all
355
+ # the default parameter values, pass an empty Hash as a request object (see above).
356
+ #
343
357
  # @param parent [String]
344
358
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::Secret Secret} to associate with the
345
359
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} in the format `projects/*/secrets/*`.
346
- # @param payload [Google::Cloud::SecretManager::V1beta1::SecretPayload | Hash]
360
+ # @param payload [Google::Cloud::SecretManager::V1beta1::SecretPayload, Hash]
347
361
  # Required. The secret payload of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
348
362
  #
349
- #
350
363
  # @yield [response, operation] Access the result along with the RPC operation
351
364
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::SecretVersion]
352
365
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -396,16 +409,23 @@ module Google
396
409
  # Gets metadata for a given {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
397
410
  #
398
411
  # @overload get_secret(request, options = nil)
399
- # @param request [Google::Cloud::SecretManager::V1beta1::GetSecretRequest | Hash]
400
- # Gets metadata for a given {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
412
+ # Pass arguments to `get_secret` via a request object, either of type
413
+ # {Google::Cloud::SecretManager::V1beta1::GetSecretRequest} or an equivalent Hash.
414
+ #
415
+ # @param request [Google::Cloud::SecretManager::V1beta1::GetSecretRequest, Hash]
416
+ # A request object representing the call parameters. Required. To specify no
417
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
401
418
  # @param options [Gapic::CallOptions, Hash]
402
419
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
403
420
  #
404
421
  # @overload get_secret(name: nil)
422
+ # Pass arguments to `get_secret` via keyword arguments. Note that at
423
+ # least one keyword argument is required. To specify no parameters, or to keep all
424
+ # the default parameter values, pass an empty Hash as a request object (see above).
425
+ #
405
426
  # @param name [String]
406
427
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::Secret Secret}, in the format `projects/*/secrets/*`.
407
428
  #
408
- #
409
429
  # @yield [response, operation] Access the result along with the RPC operation
410
430
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::Secret]
411
431
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -455,18 +475,25 @@ module Google
455
475
  # Updates metadata of an existing {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
456
476
  #
457
477
  # @overload update_secret(request, options = nil)
458
- # @param request [Google::Cloud::SecretManager::V1beta1::UpdateSecretRequest | Hash]
459
- # Updates metadata of an existing {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
478
+ # Pass arguments to `update_secret` via a request object, either of type
479
+ # {Google::Cloud::SecretManager::V1beta1::UpdateSecretRequest} or an equivalent Hash.
480
+ #
481
+ # @param request [Google::Cloud::SecretManager::V1beta1::UpdateSecretRequest, Hash]
482
+ # A request object representing the call parameters. Required. To specify no
483
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
460
484
  # @param options [Gapic::CallOptions, Hash]
461
485
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
462
486
  #
463
487
  # @overload update_secret(secret: nil, update_mask: nil)
464
- # @param secret [Google::Cloud::SecretManager::V1beta1::Secret | Hash]
488
+ # Pass arguments to `update_secret` via keyword arguments. Note that at
489
+ # least one keyword argument is required. To specify no parameters, or to keep all
490
+ # the default parameter values, pass an empty Hash as a request object (see above).
491
+ #
492
+ # @param secret [Google::Cloud::SecretManager::V1beta1::Secret, Hash]
465
493
  # Required. {Google::Cloud::SecretManager::V1beta1::Secret Secret} with updated field values.
466
- # @param update_mask [Google::Protobuf::FieldMask | Hash]
494
+ # @param update_mask [Google::Protobuf::FieldMask, Hash]
467
495
  # Required. Specifies the fields to be updated.
468
496
  #
469
- #
470
497
  # @yield [response, operation] Access the result along with the RPC operation
471
498
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::Secret]
472
499
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -516,17 +543,24 @@ module Google
516
543
  # Deletes a {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
517
544
  #
518
545
  # @overload delete_secret(request, options = nil)
519
- # @param request [Google::Cloud::SecretManager::V1beta1::DeleteSecretRequest | Hash]
520
- # Deletes a {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
546
+ # Pass arguments to `delete_secret` via a request object, either of type
547
+ # {Google::Cloud::SecretManager::V1beta1::DeleteSecretRequest} or an equivalent Hash.
548
+ #
549
+ # @param request [Google::Cloud::SecretManager::V1beta1::DeleteSecretRequest, Hash]
550
+ # A request object representing the call parameters. Required. To specify no
551
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
521
552
  # @param options [Gapic::CallOptions, Hash]
522
553
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
523
554
  #
524
555
  # @overload delete_secret(name: nil)
556
+ # Pass arguments to `delete_secret` via keyword arguments. Note that at
557
+ # least one keyword argument is required. To specify no parameters, or to keep all
558
+ # the default parameter values, pass an empty Hash as a request object (see above).
559
+ #
525
560
  # @param name [String]
526
561
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::Secret Secret} to delete in the format
527
562
  # `projects/*/secrets/*`.
528
563
  #
529
- #
530
564
  # @yield [response, operation] Access the result along with the RPC operation
531
565
  # @yieldparam response [Google::Protobuf::Empty]
532
566
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -577,13 +611,20 @@ module Google
577
611
  # data.
578
612
  #
579
613
  # @overload list_secret_versions(request, options = nil)
580
- # @param request [Google::Cloud::SecretManager::V1beta1::ListSecretVersionsRequest | Hash]
581
- # Lists {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersions}. This call does not return secret
582
- # data.
614
+ # Pass arguments to `list_secret_versions` via a request object, either of type
615
+ # {Google::Cloud::SecretManager::V1beta1::ListSecretVersionsRequest} or an equivalent Hash.
616
+ #
617
+ # @param request [Google::Cloud::SecretManager::V1beta1::ListSecretVersionsRequest, Hash]
618
+ # A request object representing the call parameters. Required. To specify no
619
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
583
620
  # @param options [Gapic::CallOptions, Hash]
584
621
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
585
622
  #
586
623
  # @overload list_secret_versions(parent: nil, page_size: nil, page_token: nil)
624
+ # Pass arguments to `list_secret_versions` via keyword arguments. Note that at
625
+ # least one keyword argument is required. To specify no parameters, or to keep all
626
+ # the default parameter values, pass an empty Hash as a request object (see above).
627
+ #
587
628
  # @param parent [String]
588
629
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::Secret Secret} associated with the
589
630
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersions} to list, in the format
@@ -596,7 +637,6 @@ module Google
596
637
  # Optional. Pagination token, returned earlier via
597
638
  # ListSecretVersionsResponse.next_page_token][].
598
639
  #
599
- #
600
640
  # @yield [response, operation] Access the result along with the RPC operation
601
641
  # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::SecretManager::V1beta1::SecretVersion>]
602
642
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -650,22 +690,26 @@ module Google
650
690
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
651
691
  #
652
692
  # @overload get_secret_version(request, options = nil)
653
- # @param request [Google::Cloud::SecretManager::V1beta1::GetSecretVersionRequest | Hash]
654
- # Gets metadata for a {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
693
+ # Pass arguments to `get_secret_version` via a request object, either of type
694
+ # {Google::Cloud::SecretManager::V1beta1::GetSecretVersionRequest} or an equivalent Hash.
655
695
  #
656
- # `projects/*/secrets/*/versions/latest` is an alias to the `latest`
657
- # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
696
+ # @param request [Google::Cloud::SecretManager::V1beta1::GetSecretVersionRequest, Hash]
697
+ # A request object representing the call parameters. Required. To specify no
698
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
658
699
  # @param options [Gapic::CallOptions, Hash]
659
700
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
660
701
  #
661
702
  # @overload get_secret_version(name: nil)
703
+ # Pass arguments to `get_secret_version` via keyword arguments. Note that at
704
+ # least one keyword argument is required. To specify no parameters, or to keep all
705
+ # the default parameter values, pass an empty Hash as a request object (see above).
706
+ #
662
707
  # @param name [String]
663
708
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} in the format
664
709
  # `projects/*/secrets/*/versions/*`.
665
710
  # `projects/*/secrets/*/versions/latest` is an alias to the `latest`
666
711
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
667
712
  #
668
- #
669
713
  # @yield [response, operation] Access the result along with the RPC operation
670
714
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::SecretVersion]
671
715
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -718,20 +762,24 @@ module Google
718
762
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
719
763
  #
720
764
  # @overload access_secret_version(request, options = nil)
721
- # @param request [Google::Cloud::SecretManager::V1beta1::AccessSecretVersionRequest | Hash]
722
- # Accesses a {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}. This call returns the secret data.
765
+ # Pass arguments to `access_secret_version` via a request object, either of type
766
+ # {Google::Cloud::SecretManager::V1beta1::AccessSecretVersionRequest} or an equivalent Hash.
723
767
  #
724
- # `projects/*/secrets/*/versions/latest` is an alias to the `latest`
725
- # {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
768
+ # @param request [Google::Cloud::SecretManager::V1beta1::AccessSecretVersionRequest, Hash]
769
+ # A request object representing the call parameters. Required. To specify no
770
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
726
771
  # @param options [Gapic::CallOptions, Hash]
727
772
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
728
773
  #
729
774
  # @overload access_secret_version(name: nil)
775
+ # Pass arguments to `access_secret_version` via keyword arguments. Note that at
776
+ # least one keyword argument is required. To specify no parameters, or to keep all
777
+ # the default parameter values, pass an empty Hash as a request object (see above).
778
+ #
730
779
  # @param name [String]
731
780
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} in the format
732
781
  # `projects/*/secrets/*/versions/*`.
733
782
  #
734
- #
735
783
  # @yield [response, operation] Access the result along with the RPC operation
736
784
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::AccessSecretVersionResponse]
737
785
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -784,20 +832,24 @@ module Google
784
832
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion::State::DISABLED DISABLED}.
785
833
  #
786
834
  # @overload disable_secret_version(request, options = nil)
787
- # @param request [Google::Cloud::SecretManager::V1beta1::DisableSecretVersionRequest | Hash]
788
- # Disables a {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
835
+ # Pass arguments to `disable_secret_version` via a request object, either of type
836
+ # {Google::Cloud::SecretManager::V1beta1::DisableSecretVersionRequest} or an equivalent Hash.
789
837
  #
790
- # Sets the {Google::Cloud::SecretManager::V1beta1::SecretVersion#state state} of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to
791
- # {Google::Cloud::SecretManager::V1beta1::SecretVersion::State::DISABLED DISABLED}.
838
+ # @param request [Google::Cloud::SecretManager::V1beta1::DisableSecretVersionRequest, Hash]
839
+ # A request object representing the call parameters. Required. To specify no
840
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
792
841
  # @param options [Gapic::CallOptions, Hash]
793
842
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
794
843
  #
795
844
  # @overload disable_secret_version(name: nil)
845
+ # Pass arguments to `disable_secret_version` via keyword arguments. Note that at
846
+ # least one keyword argument is required. To specify no parameters, or to keep all
847
+ # the default parameter values, pass an empty Hash as a request object (see above).
848
+ #
796
849
  # @param name [String]
797
850
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to disable in the format
798
851
  # `projects/*/secrets/*/versions/*`.
799
852
  #
800
- #
801
853
  # @yield [response, operation] Access the result along with the RPC operation
802
854
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::SecretVersion]
803
855
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -850,20 +902,24 @@ module Google
850
902
  # {Google::Cloud::SecretManager::V1beta1::SecretVersion::State::ENABLED ENABLED}.
851
903
  #
852
904
  # @overload enable_secret_version(request, options = nil)
853
- # @param request [Google::Cloud::SecretManager::V1beta1::EnableSecretVersionRequest | Hash]
854
- # Enables a {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
905
+ # Pass arguments to `enable_secret_version` via a request object, either of type
906
+ # {Google::Cloud::SecretManager::V1beta1::EnableSecretVersionRequest} or an equivalent Hash.
855
907
  #
856
- # Sets the {Google::Cloud::SecretManager::V1beta1::SecretVersion#state state} of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to
857
- # {Google::Cloud::SecretManager::V1beta1::SecretVersion::State::ENABLED ENABLED}.
908
+ # @param request [Google::Cloud::SecretManager::V1beta1::EnableSecretVersionRequest, Hash]
909
+ # A request object representing the call parameters. Required. To specify no
910
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
858
911
  # @param options [Gapic::CallOptions, Hash]
859
912
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
860
913
  #
861
914
  # @overload enable_secret_version(name: nil)
915
+ # Pass arguments to `enable_secret_version` via keyword arguments. Note that at
916
+ # least one keyword argument is required. To specify no parameters, or to keep all
917
+ # the default parameter values, pass an empty Hash as a request object (see above).
918
+ #
862
919
  # @param name [String]
863
920
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to enable in the format
864
921
  # `projects/*/secrets/*/versions/*`.
865
922
  #
866
- #
867
923
  # @yield [response, operation] Access the result along with the RPC operation
868
924
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::SecretVersion]
869
925
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -917,21 +973,24 @@ module Google
917
973
  # secret data.
918
974
  #
919
975
  # @overload destroy_secret_version(request, options = nil)
920
- # @param request [Google::Cloud::SecretManager::V1beta1::DestroySecretVersionRequest | Hash]
921
- # Destroys a {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}.
976
+ # Pass arguments to `destroy_secret_version` via a request object, either of type
977
+ # {Google::Cloud::SecretManager::V1beta1::DestroySecretVersionRequest} or an equivalent Hash.
922
978
  #
923
- # Sets the {Google::Cloud::SecretManager::V1beta1::SecretVersion#state state} of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to
924
- # {Google::Cloud::SecretManager::V1beta1::SecretVersion::State::DESTROYED DESTROYED} and irrevocably destroys the
925
- # secret data.
979
+ # @param request [Google::Cloud::SecretManager::V1beta1::DestroySecretVersionRequest, Hash]
980
+ # A request object representing the call parameters. Required. To specify no
981
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
926
982
  # @param options [Gapic::CallOptions, Hash]
927
983
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
928
984
  #
929
985
  # @overload destroy_secret_version(name: nil)
986
+ # Pass arguments to `destroy_secret_version` via keyword arguments. Note that at
987
+ # least one keyword argument is required. To specify no parameters, or to keep all
988
+ # the default parameter values, pass an empty Hash as a request object (see above).
989
+ #
930
990
  # @param name [String]
931
991
  # Required. The resource name of the {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion} to destroy in the format
932
992
  # `projects/*/secrets/*/versions/*`.
933
993
  #
934
- #
935
994
  # @yield [response, operation] Access the result along with the RPC operation
936
995
  # @yieldparam response [Google::Cloud::SecretManager::V1beta1::SecretVersion]
937
996
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -985,27 +1044,29 @@ module Google
985
1044
  # to the policy set on the associated {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
986
1045
  #
987
1046
  # @overload set_iam_policy(request, options = nil)
988
- # @param request [Google::Iam::V1::SetIamPolicyRequest | Hash]
989
- # Sets the access control policy on the specified secret. Replaces any
990
- # existing policy.
1047
+ # Pass arguments to `set_iam_policy` via a request object, either of type
1048
+ # {Google::Iam::V1::SetIamPolicyRequest} or an equivalent Hash.
991
1049
  #
992
- # Permissions on {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersions} are enforced according
993
- # to the policy set on the associated {Google::Cloud::SecretManager::V1beta1::Secret Secret}.
1050
+ # @param request [Google::Iam::V1::SetIamPolicyRequest, Hash]
1051
+ # A request object representing the call parameters. Required. To specify no
1052
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
994
1053
  # @param options [Gapic::CallOptions, Hash]
995
1054
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
996
1055
  #
997
1056
  # @overload set_iam_policy(resource: nil, policy: nil)
1057
+ # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
1058
+ # least one keyword argument is required. To specify no parameters, or to keep all
1059
+ # the default parameter values, pass an empty Hash as a request object (see above).
1060
+ #
998
1061
  # @param resource [String]
999
1062
  # REQUIRED: The resource for which the policy is being specified.
1000
- # `resource` is usually specified as a path. For example, a Project
1001
- # resource is specified as `projects/{project}`.
1002
- # @param policy [Google::Iam::V1::Policy | Hash]
1063
+ # See the operation documentation for the appropriate value for this field.
1064
+ # @param policy [Google::Iam::V1::Policy, Hash]
1003
1065
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
1004
1066
  # the policy is limited to a few 10s of KB. An empty policy is a
1005
1067
  # valid policy but certain Cloud Platform services (such as Projects)
1006
1068
  # might reject them.
1007
1069
  #
1008
- #
1009
1070
  # @yield [response, operation] Access the result along with the RPC operation
1010
1071
  # @yieldparam response [Google::Iam::V1::Policy]
1011
1072
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1056,18 +1117,26 @@ module Google
1056
1117
  # Returns empty policy if the secret exists and does not have a policy set.
1057
1118
  #
1058
1119
  # @overload get_iam_policy(request, options = nil)
1059
- # @param request [Google::Iam::V1::GetIamPolicyRequest | Hash]
1060
- # Gets the access control policy for a secret.
1061
- # Returns empty policy if the secret exists and does not have a policy set.
1120
+ # Pass arguments to `get_iam_policy` via a request object, either of type
1121
+ # {Google::Iam::V1::GetIamPolicyRequest} or an equivalent Hash.
1122
+ #
1123
+ # @param request [Google::Iam::V1::GetIamPolicyRequest, Hash]
1124
+ # A request object representing the call parameters. Required. To specify no
1125
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1062
1126
  # @param options [Gapic::CallOptions, Hash]
1063
1127
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1064
1128
  #
1065
- # @overload get_iam_policy(resource: nil)
1129
+ # @overload get_iam_policy(resource: nil, options: nil)
1130
+ # Pass arguments to `get_iam_policy` via keyword arguments. Note that at
1131
+ # least one keyword argument is required. To specify no parameters, or to keep all
1132
+ # the default parameter values, pass an empty Hash as a request object (see above).
1133
+ #
1066
1134
  # @param resource [String]
1067
1135
  # REQUIRED: The resource for which the policy is being requested.
1068
- # `resource` is usually specified as a path. For example, a Project
1069
- # resource is specified as `projects/{project}`.
1070
- #
1136
+ # See the operation documentation for the appropriate value for this field.
1137
+ # @param options [Google::Iam::V1::GetPolicyOptions, Hash]
1138
+ # OPTIONAL: A `GetPolicyOptions` object for specifying options to
1139
+ # `GetIamPolicy`. This field is only used by Cloud IAM.
1071
1140
  #
1072
1141
  # @yield [response, operation] Access the result along with the RPC operation
1073
1142
  # @yieldparam response [Google::Iam::V1::Policy]
@@ -1124,29 +1193,29 @@ module Google
1124
1193
  # may "fail open" without warning.
1125
1194
  #
1126
1195
  # @overload test_iam_permissions(request, options = nil)
1127
- # @param request [Google::Iam::V1::TestIamPermissionsRequest | Hash]
1128
- # Returns permissions that a caller has for the specified secret.
1129
- # If the secret does not exist, this call returns an empty set of
1130
- # permissions, not a NOT_FOUND error.
1131
- #
1132
- # Note: This operation is designed to be used for building permission-aware
1133
- # UIs and command-line tools, not for authorization checking. This operation
1134
- # may "fail open" without warning.
1196
+ # Pass arguments to `test_iam_permissions` via a request object, either of type
1197
+ # {Google::Iam::V1::TestIamPermissionsRequest} or an equivalent Hash.
1198
+ #
1199
+ # @param request [Google::Iam::V1::TestIamPermissionsRequest, Hash]
1200
+ # A request object representing the call parameters. Required. To specify no
1201
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1135
1202
  # @param options [Gapic::CallOptions, Hash]
1136
1203
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1137
1204
  #
1138
1205
  # @overload test_iam_permissions(resource: nil, permissions: nil)
1206
+ # Pass arguments to `test_iam_permissions` via keyword arguments. Note that at
1207
+ # least one keyword argument is required. To specify no parameters, or to keep all
1208
+ # the default parameter values, pass an empty Hash as a request object (see above).
1209
+ #
1139
1210
  # @param resource [String]
1140
1211
  # REQUIRED: The resource for which the policy detail is being requested.
1141
- # `resource` is usually specified as a path. For example, a Project
1142
- # resource is specified as `projects/{project}`.
1212
+ # See the operation documentation for the appropriate value for this field.
1143
1213
  # @param permissions [Array<String>]
1144
1214
  # The set of permissions to check for the `resource`. Permissions with
1145
1215
  # wildcards (such as '*' or 'storage.*') are not allowed. For more
1146
1216
  # information see
1147
1217
  # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
1148
1218
  #
1149
- #
1150
1219
  # @yield [response, operation] Access the result along with the RPC operation
1151
1220
  # @yieldparam response [Google::Iam::V1::TestIamPermissionsResponse]
1152
1221
  # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -1443,13 +1512,3 @@ module Google
1443
1512
  end
1444
1513
  end
1445
1514
  end
1446
-
1447
- # rubocop:disable Lint/HandleExceptions
1448
-
1449
- # Once client is loaded, load helpers.rb if it exists.
1450
- begin
1451
- require "google/cloud/secret_manager/v1beta1/secret_manager_service/helpers"
1452
- rescue LoadError
1453
- end
1454
-
1455
- # rubocop:enable Lint/HandleExceptions
@@ -16,5 +16,40 @@
16
16
 
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
- require "google/cloud/secret_manager/v1beta1/secret_manager_service/client"
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/secret_manager/v1beta1/version"
24
+
20
25
  require "google/cloud/secret_manager/v1beta1/secret_manager_service/credentials"
26
+ require "google/cloud/secret_manager/v1beta1/secret_manager_service/paths"
27
+ require "google/cloud/secret_manager/v1beta1/secret_manager_service/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module SecretManager
32
+ module V1beta1
33
+ ##
34
+ # Secret Manager Service
35
+ #
36
+ # Manages secrets and operations using those secrets. Implements a REST
37
+ # model with the following objects:
38
+ #
39
+ # * {Google::Cloud::SecretManager::V1beta1::Secret Secret}
40
+ # * {Google::Cloud::SecretManager::V1beta1::SecretVersion SecretVersion}
41
+ #
42
+ # To load this service and instantiate a client:
43
+ #
44
+ # require "google/cloud/secret_manager/v1beta1/secret_manager_service"
45
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
46
+ #
47
+ module SecretManagerService
48
+ end
49
+ end
50
+ end
51
+ end
52
+ end
53
+
54
+ helper_path = ::File.join __dir__, "secret_manager_service", "helpers.rb"
55
+ require "google/cloud/secret_manager/v1beta1/secret_manager_service/helpers" if ::File.file? helper_path
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module SecretManager
23
23
  module V1beta1
24
- VERSION = "0.4.1"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -17,3 +17,19 @@
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
19
  require "google/cloud/secret_manager/v1beta1/secret_manager_service"
20
+ require "google/cloud/secret_manager/v1beta1/version"
21
+
22
+ module Google
23
+ module Cloud
24
+ module SecretManager
25
+ ##
26
+ # To load this package, including all its services, and instantiate a client:
27
+ #
28
+ # require "google/cloud/secret_manager/v1beta1"
29
+ # client = Google::Cloud::SecretManager::V1beta1::SecretManagerService::Client.new
30
+ #
31
+ module V1beta1
32
+ end
33
+ end
34
+ end
35
+ end
@@ -1 +1,21 @@
1
- require "google/cloud/secret_manager/v1beta1/version"
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ # This gem does not autoload during Bundler.require. To load this gem,
20
+ # issue explicit require statements for the packages desired, e.g.:
21
+ # require "google/cloud/secret_manager/v1beta1"
@@ -24,8 +24,7 @@ module Google
24
24
  # @!attribute [rw] resource
25
25
  # @return [String]
26
26
  # REQUIRED: The resource for which the policy is being specified.
27
- # `resource` is usually specified as a path. For example, a Project
28
- # resource is specified as `projects/{project}`.
27
+ # See the operation documentation for the appropriate value for this field.
29
28
  # @!attribute [rw] policy
30
29
  # @return [Google::Iam::V1::Policy]
31
30
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
@@ -41,8 +40,11 @@ module Google
41
40
  # @!attribute [rw] resource
42
41
  # @return [String]
43
42
  # REQUIRED: The resource for which the policy is being requested.
44
- # `resource` is usually specified as a path. For example, a Project
45
- # resource is specified as `projects/{project}`.
43
+ # See the operation documentation for the appropriate value for this field.
44
+ # @!attribute [rw] options
45
+ # @return [Google::Iam::V1::GetPolicyOptions]
46
+ # OPTIONAL: A `GetPolicyOptions` object for specifying options to
47
+ # `GetIamPolicy`. This field is only used by Cloud IAM.
46
48
  class GetIamPolicyRequest
47
49
  include Google::Protobuf::MessageExts
48
50
  extend Google::Protobuf::MessageExts::ClassMethods
@@ -52,8 +54,7 @@ module Google
52
54
  # @!attribute [rw] resource
53
55
  # @return [String]
54
56
  # REQUIRED: The resource for which the policy detail is being requested.
55
- # `resource` is usually specified as a path. For example, a Project
56
- # resource is specified as `projects/{project}`.
57
+ # See the operation documentation for the appropriate value for this field.
57
58
  # @!attribute [rw] permissions
58
59
  # @return [Array<String>]
59
60
  # The set of permissions to check for the `resource`. Permissions with
@@ -0,0 +1,40 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Iam
22
+ module V1
23
+ # Encapsulates settings provided to GetIamPolicy.
24
+ # @!attribute [rw] requested_policy_version
25
+ # @return [Integer]
26
+ # Optional. The policy format version to be returned.
27
+ #
28
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
29
+ # rejected.
30
+ #
31
+ # Requests for policies with any conditional bindings must specify version 3.
32
+ # Policies without any conditional bindings may specify any valid value or
33
+ # leave the field unset.
34
+ class GetPolicyOptions
35
+ include Google::Protobuf::MessageExts
36
+ extend Google::Protobuf::MessageExts::ClassMethods
37
+ end
38
+ end
39
+ end
40
+ end
@@ -24,40 +24,79 @@ module Google
24
24
  # specify access control policies for Cloud Platform resources.
25
25
  #
26
26
  #
27
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
28
- # `members` to a `role`, where the members can be user accounts, Google groups,
29
- # Google domains, and service accounts. A `role` is a named list of permissions
30
- # defined by IAM.
27
+ # A `Policy` is a collection of `bindings`. A `binding` binds one or more
28
+ # `members` to a single `role`. Members can be user accounts, service accounts,
29
+ # Google groups, and domains (such as G Suite). A `role` is a named list of
30
+ # permissions (defined by IAM or configured by users). A `binding` can
31
+ # optionally specify a `condition`, which is a logic expression that further
32
+ # constrains the role binding based on attributes about the request and/or
33
+ # target resource.
31
34
  #
32
- # **Example**
35
+ # **JSON Example**
33
36
  #
34
37
  # {
35
38
  # "bindings": [
36
39
  # {
37
- # "role": "roles/owner",
40
+ # "role": "roles/resourcemanager.organizationAdmin",
38
41
  # "members": [
39
42
  # "user:mike@example.com",
40
43
  # "group:admins@example.com",
41
44
  # "domain:google.com",
42
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
45
+ # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
43
46
  # ]
44
47
  # },
45
48
  # {
46
- # "role": "roles/viewer",
47
- # "members": ["user:sean@example.com"]
49
+ # "role": "roles/resourcemanager.organizationViewer",
50
+ # "members": ["user:eve@example.com"],
51
+ # "condition": {
52
+ # "title": "expirable access",
53
+ # "description": "Does not grant access after Sep 2020",
54
+ # "expression": "request.time <
55
+ # timestamp('2020-10-01T00:00:00.000Z')",
56
+ # }
48
57
  # }
49
58
  # ]
50
59
  # }
51
60
  #
61
+ # **YAML Example**
62
+ #
63
+ # bindings:
64
+ # - members:
65
+ # - user:mike@example.com
66
+ # - group:admins@example.com
67
+ # - domain:google.com
68
+ # - serviceAccount:my-project-id@appspot.gserviceaccount.com
69
+ # role: roles/resourcemanager.organizationAdmin
70
+ # - members:
71
+ # - user:eve@example.com
72
+ # role: roles/resourcemanager.organizationViewer
73
+ # condition:
74
+ # title: expirable access
75
+ # description: Does not grant access after Sep 2020
76
+ # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
77
+ #
52
78
  # For a description of IAM and its features, see the
53
- # [IAM developer's guide](https://cloud.google.com/iam).
79
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
54
80
  # @!attribute [rw] version
55
81
  # @return [Integer]
56
- # Version of the `Policy`. The default version is 0.
82
+ # Specifies the format of the policy.
83
+ #
84
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
85
+ # rejected.
86
+ #
87
+ # Operations affecting conditional bindings must specify version 3. This can
88
+ # be either setting a conditional policy, modifying a conditional binding,
89
+ # or removing a binding (conditional or unconditional) from the stored
90
+ # conditional policy.
91
+ # Operations on non-conditional policies may specify any valid value or
92
+ # leave the field unset.
93
+ #
94
+ # If no etag is provided in the call to `setIamPolicy`, version compliance
95
+ # checks against the stored policy is skipped.
57
96
  # @!attribute [rw] bindings
58
97
  # @return [Array<Google::Iam::V1::Binding>]
59
- # Associates a list of `members` to a `role`.
60
- # Multiple `bindings` must not be specified for the same `role`.
98
+ # Associates a list of `members` to a `role`. Optionally may specify a
99
+ # `condition` that determines when binding is in effect.
61
100
  # `bindings` with no members will result in an error.
62
101
  # @!attribute [rw] etag
63
102
  # @return [String]
@@ -70,7 +109,9 @@ module Google
70
109
  # ensure that their change will be applied to the same version of the policy.
71
110
  #
72
111
  # If no `etag` is provided in the call to `setIamPolicy`, then the existing
73
- # policy is overwritten blindly.
112
+ # policy is overwritten. Due to blind-set semantics of an etag-less policy,
113
+ # 'setIamPolicy' will not fail even if the incoming policy version does not
114
+ # meet the requirements for modifying the stored policy.
74
115
  class Policy
75
116
  include Google::Protobuf::MessageExts
76
117
  extend Google::Protobuf::MessageExts::ClassMethods
@@ -81,7 +122,6 @@ module Google
81
122
  # @return [String]
82
123
  # Role that is assigned to `members`.
83
124
  # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
84
- # Required
85
125
  # @!attribute [rw] members
86
126
  # @return [Array<String>]
87
127
  # Specifies the identities requesting access for a Cloud Platform resource.
@@ -94,7 +134,7 @@ module Google
94
134
  # who is authenticated with a Google account or a service account.
95
135
  #
96
136
  # * `user:{emailid}`: An email address that represents a specific Google
97
- # account. For example, `alice@gmail.com` or `joe@example.com`.
137
+ # account. For example, `alice@example.com` .
98
138
  #
99
139
  #
100
140
  # * `serviceAccount:{emailid}`: An email address that represents a service
@@ -103,8 +143,15 @@ module Google
103
143
  # * `group:{emailid}`: An email address that represents a Google group.
104
144
  # For example, `admins@example.com`.
105
145
  #
106
- # * `domain:{domain}`: A Google Apps domain name that represents all the
146
+ #
147
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
107
148
  # users of that domain. For example, `google.com` or `example.com`.
149
+ # @!attribute [rw] condition
150
+ # @return [Google::Type::Expr]
151
+ # The condition that is associated with this binding.
152
+ # NOTE: An unsatisfied condition will not allow user access via current
153
+ # binding. Different bindings, including their conditions, are examined
154
+ # independently.
108
155
  class Binding
109
156
  include Google::Protobuf::MessageExts
110
157
  extend Google::Protobuf::MessageExts::ClassMethods
@@ -114,6 +161,9 @@ module Google
114
161
  # @!attribute [rw] binding_deltas
115
162
  # @return [Array<Google::Iam::V1::BindingDelta>]
116
163
  # The delta for Bindings between two policies.
164
+ # @!attribute [rw] audit_config_deltas
165
+ # @return [Array<Google::Iam::V1::AuditConfigDelta>]
166
+ # The delta for AuditConfigs between two policies.
117
167
  class PolicyDelta
118
168
  include Google::Protobuf::MessageExts
119
169
  extend Google::Protobuf::MessageExts::ClassMethods
@@ -135,6 +185,9 @@ module Google
135
185
  # A single identity requesting access for a Cloud Platform resource.
136
186
  # Follows the same format of Binding.members.
137
187
  # Required
188
+ # @!attribute [rw] condition
189
+ # @return [Google::Type::Expr]
190
+ # The condition that is associated with this binding.
138
191
  class BindingDelta
139
192
  include Google::Protobuf::MessageExts
140
193
  extend Google::Protobuf::MessageExts::ClassMethods
@@ -151,6 +204,45 @@ module Google
151
204
  REMOVE = 2
152
205
  end
153
206
  end
207
+
208
+ # One delta entry for AuditConfig. Each individual change (only one
209
+ # exempted_member in each entry) to a AuditConfig will be a separate entry.
210
+ # @!attribute [rw] action
211
+ # @return [Google::Iam::V1::AuditConfigDelta::Action]
212
+ # The action that was performed on an audit configuration in a policy.
213
+ # Required
214
+ # @!attribute [rw] service
215
+ # @return [String]
216
+ # Specifies a service that was configured for Cloud Audit Logging.
217
+ # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
218
+ # `allServices` is a special value that covers all services.
219
+ # Required
220
+ # @!attribute [rw] exempted_member
221
+ # @return [String]
222
+ # A single identity that is exempted from "data access" audit
223
+ # logging for the `service` specified above.
224
+ # Follows the same format of Binding.members.
225
+ # @!attribute [rw] log_type
226
+ # @return [String]
227
+ # Specifies the log_type that was be enabled. ADMIN_ACTIVITY is always
228
+ # enabled, and cannot be configured.
229
+ # Required
230
+ class AuditConfigDelta
231
+ include Google::Protobuf::MessageExts
232
+ extend Google::Protobuf::MessageExts::ClassMethods
233
+
234
+ # The type of action performed on an audit configuration in a policy.
235
+ module Action
236
+ # Unspecified.
237
+ ACTION_UNSPECIFIED = 0
238
+
239
+ # Addition of an audit configuration.
240
+ ADD = 1
241
+
242
+ # Removal of an audit configuration.
243
+ REMOVE = 2
244
+ end
245
+ end
154
246
  end
155
247
  end
156
248
  end
@@ -0,0 +1,52 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2020 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Type
22
+ # Represents an expression text. Example:
23
+ #
24
+ # title: "User account presence"
25
+ # description: "Determines whether the request has a user account"
26
+ # expression: "size(request.user) > 0"
27
+ # @!attribute [rw] expression
28
+ # @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.
34
+ # @!attribute [rw] title
35
+ # @return [String]
36
+ # An optional title for the expression, i.e. a short string describing
37
+ # its purpose. This can be used e.g. in UIs which allow to enter the
38
+ # expression.
39
+ # @!attribute [rw] description
40
+ # @return [String]
41
+ # An optional description of the expression. This is a longer text which
42
+ # describes the expression, e.g. when hovered over it in a UI.
43
+ # @!attribute [rw] location
44
+ # @return [String]
45
+ # An optional string indicating the location of the expression for error
46
+ # reporting, e.g. a file name and a position in the file.
47
+ class Expr
48
+ include Google::Protobuf::MessageExts
49
+ extend Google::Protobuf::MessageExts::ClassMethods
50
+ end
51
+ end
52
+ end
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.4.1
4
+ version: 0.5.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: 2020-04-01 00:00:00.000000000 Z
11
+ date: 2020-04-13 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -42,16 +42,22 @@ dependencies:
42
42
  name: grpc-google-iam-v1
43
43
  requirement: !ruby/object:Gem::Requirement
44
44
  requirements:
45
- - - "~>"
45
+ - - ">="
46
+ - !ruby/object:Gem::Version
47
+ version: 0.6.10
48
+ - - "<"
46
49
  - !ruby/object:Gem::Version
47
- version: 0.6.9
50
+ version: '2.0'
48
51
  type: :runtime
49
52
  prerelease: false
50
53
  version_requirements: !ruby/object:Gem::Requirement
51
54
  requirements:
52
- - - "~>"
55
+ - - ">="
56
+ - !ruby/object:Gem::Version
57
+ version: 0.6.10
58
+ - - "<"
53
59
  - !ruby/object:Gem::Version
54
- version: 0.6.9
60
+ version: '2.0'
55
61
  - !ruby/object:Gem::Dependency
56
62
  name: google-style
57
63
  requirement: !ruby/object:Gem::Requirement
@@ -166,10 +172,12 @@ files:
166
172
  - proto_docs/google/cloud/secrets/v1beta1/resources.rb
167
173
  - proto_docs/google/cloud/secrets/v1beta1/service.rb
168
174
  - proto_docs/google/iam/v1/iam_policy.rb
175
+ - proto_docs/google/iam/v1/options.rb
169
176
  - proto_docs/google/iam/v1/policy.rb
170
177
  - proto_docs/google/protobuf/empty.rb
171
178
  - proto_docs/google/protobuf/field_mask.rb
172
179
  - proto_docs/google/protobuf/timestamp.rb
180
+ - proto_docs/google/type/expr.rb
173
181
  homepage: https://github.com/googleapis/google-cloud-ruby
174
182
  licenses:
175
183
  - Apache-2.0