google-cloud-secret_manager-v1beta1 0.4.1 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 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