google-apis-secretmanager_v1 0.37.0 → 0.39.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: fae74cc59bec6c5a083d08d7aabcbdd2d8049f0a1beeafbb14cf3487c862e0e4
4
- data.tar.gz: d5b7e061ea152251c5253c5daa6a72a1ef5d04594d4cfc4ac5354c80b44eadd5
3
+ metadata.gz: ec144097eabea0b6d6f9ad901ff79e24cceacae34e10a3699fcfe5d75afdd736
4
+ data.tar.gz: 110708693afa8b79dbdf89b27c95d7cc5bee1ff1eae523f7126f8a0893ed320b
5
5
  SHA512:
6
- metadata.gz: e60179f824e20273e3197a8a1f8d6fdcfad304af81a1d8b5ac7e9e4be208456b831b4424f3d577a68e9078681403aff22273759c0ba6c36e7445b14645d6bd9a
7
- data.tar.gz: 95aca29076b2fcc0115f137e9fed70851da3f63ca5bdc200fcafa2df95d36f61ad5c718a0c4c0b72c25299ff549495af294a8f010d8090f6714740996ecca12e
6
+ metadata.gz: cbe43b3e51a28eb74b037e1cfa0e3c2f4e43e2db7d9a4b09f327dc0fe4e2e3bdb3d8be7e42d71ae8b80fe74693e8e0d5f335b63ce9cd957405606b152dc328dc
7
+ data.tar.gz: b9ce7f227ecbb17ec0070e52c2b9a5f51ed28c48043aadd0ebd85d006ab2239a187402ed19666a415f55f5c6945e4d3adff52d0c54773d7a829886ac1b1c371d
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-secretmanager_v1
2
2
 
3
+ ### v0.39.0 (2024-02-04)
4
+
5
+ * Regenerated from discovery document revision 20240126
6
+ * Regenerated using generator version 0.13.1
7
+
8
+ ### v0.38.0 (2024-01-23)
9
+
10
+ * Regenerated using generator version 0.13.0
11
+
3
12
  ### v0.37.0 (2023-12-24)
4
13
 
5
14
  * Regenerated from discovery document revision 20231215
@@ -27,7 +27,7 @@ module Google
27
27
  include Google::Apis::Core::Hashable
28
28
 
29
29
  # The resource name of the SecretVersion in the format `projects/*/secrets/*/
30
- # versions/*`.
30
+ # versions/*` or `projects/*/locations/*/secrets/*/versions/*`.
31
31
  # Corresponds to the JSON property `name`
32
32
  # @return [String]
33
33
  attr_accessor :name
@@ -262,7 +262,10 @@ module Google
262
262
  attr_accessor :members
263
263
 
264
264
  # Role that is assigned to the list of `members`, or principals. For example, `
265
- # roles/viewer`, `roles/editor`, or `roles/owner`.
265
+ # roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM
266
+ # roles and permissions, see the [IAM documentation](https://cloud.google.com/
267
+ # iam/docs/roles-overview). For a list of the available pre-defined roles, see [
268
+ # here](https://cloud.google.com/iam/docs/understanding-roles).
266
269
  # Corresponds to the JSON property `role`
267
270
  # @return [String]
268
271
  attr_accessor :role
@@ -908,8 +911,8 @@ module Google
908
911
  # characters. An alias string must start with a letter and cannot be the string '
909
912
  # latest' or 'NEW'. No more than 50 aliases can be assigned to a given secret.
910
913
  # Version-Alias pairs will be viewable via GetSecret and modifiable via
911
- # UpdateSecret. At launch Access by Allias will only be supported on
912
- # GetSecretVersion and AccessSecretVersion.
914
+ # UpdateSecret. Access by alias is only be supported on GetSecretVersion and
915
+ # AccessSecretVersion.
913
916
  # Corresponds to the JSON property `versionAliases`
914
917
  # @return [Hash<String,Fixnum>]
915
918
  attr_accessor :version_aliases
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SecretmanagerV1
18
18
  # Version of the google-apis-secretmanager_v1 gem
19
- GEM_VERSION = "0.37.0"
19
+ GEM_VERSION = "0.39.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.12.0"
22
+ GENERATOR_VERSION = "0.13.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20231215"
25
+ REVISION = "20240126"
26
26
  end
27
27
  end
28
28
  end
@@ -33,6 +33,8 @@ module Google
33
33
  #
34
34
  # @see https://cloud.google.com/secret-manager/
35
35
  class SecretManagerService < Google::Apis::Core::BaseService
36
+ DEFAULT_ENDPOINT_TEMPLATE = "https://secretmanager.$UNIVERSE_DOMAIN$/"
37
+
36
38
  # @return [String]
37
39
  # API key. Your API key identifies your project and provides you with API access,
38
40
  # quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -44,7 +46,7 @@ module Google
44
46
  attr_accessor :quota_user
45
47
 
46
48
  def initialize
47
- super('https://secretmanager.googleapis.com/', '',
49
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
48
50
  client_name: 'google-apis-secretmanager_v1',
49
51
  client_version: Google::Apis::SecretmanagerV1::GEM_VERSION)
50
52
  @batch_path = 'batch'
@@ -127,7 +129,7 @@ module Google
127
129
  # existing Secret.
128
130
  # @param [String] parent
129
131
  # Required. The resource name of the Secret to associate with the SecretVersion
130
- # in the format `projects/*/secrets/*`.
132
+ # in the format `projects/*/secrets/*` or `projects/*/locations/*/secrets/*`.
131
133
  # @param [Google::Apis::SecretmanagerV1::AddSecretVersionRequest] add_secret_version_request_object
132
134
  # @param [String] fields
133
135
  # Selector specifying which fields to include in a partial response.
@@ -146,7 +148,7 @@ module Google
146
148
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
147
149
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
148
150
  # @raise [Google::Apis::AuthorizationError] Authorization is required
149
- def add_project_secret_version(parent, add_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
151
+ def add_project_location_secret_version(parent, add_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
150
152
  command = make_simple_command(:post, 'v1/{+parent}:addVersion', options)
151
153
  command.request_representation = Google::Apis::SecretmanagerV1::AddSecretVersionRequest::Representation
152
154
  command.request_object = add_secret_version_request_object
@@ -161,7 +163,7 @@ module Google
161
163
  # Creates a new Secret containing no SecretVersions.
162
164
  # @param [String] parent
163
165
  # Required. The resource name of the project to associate with the Secret, in
164
- # the format `projects/*`.
166
+ # the format `projects/*` or `projects/*/locations/*`.
165
167
  # @param [Google::Apis::SecretmanagerV1::Secret] secret_object
166
168
  # @param [String] secret_id
167
169
  # Required. This must be unique within the project. A secret ID is a string with
@@ -184,7 +186,7 @@ module Google
184
186
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
185
187
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
186
188
  # @raise [Google::Apis::AuthorizationError] Authorization is required
187
- def create_project_secret(parent, secret_object = nil, secret_id: nil, fields: nil, quota_user: nil, options: nil, &block)
189
+ def create_project_location_secret(parent, secret_object = nil, secret_id: nil, fields: nil, quota_user: nil, options: nil, &block)
188
190
  command = make_simple_command(:post, 'v1/{+parent}/secrets', options)
189
191
  command.request_representation = Google::Apis::SecretmanagerV1::Secret::Representation
190
192
  command.request_object = secret_object
@@ -222,7 +224,7 @@ module Google
222
224
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
223
225
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
224
226
  # @raise [Google::Apis::AuthorizationError] Authorization is required
225
- def delete_project_secret(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
227
+ def delete_project_location_secret(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
226
228
  command = make_simple_command(:delete, 'v1/{+name}', options)
227
229
  command.response_representation = Google::Apis::SecretmanagerV1::Empty::Representation
228
230
  command.response_class = Google::Apis::SecretmanagerV1::Empty
@@ -236,7 +238,7 @@ module Google
236
238
  # Gets metadata for a given Secret.
237
239
  # @param [String] name
238
240
  # Required. The resource name of the Secret, in the format `projects/*/secrets/*`
239
- # .
241
+ # or `projects/*/locations/*/secrets/*`.
240
242
  # @param [String] fields
241
243
  # Selector specifying which fields to include in a partial response.
242
244
  # @param [String] quota_user
@@ -254,7 +256,7 @@ module Google
254
256
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
255
257
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
256
258
  # @raise [Google::Apis::AuthorizationError] Authorization is required
257
- def get_project_secret(name, fields: nil, quota_user: nil, options: nil, &block)
259
+ def get_project_location_secret(name, fields: nil, quota_user: nil, options: nil, &block)
258
260
  command = make_simple_command(:get, 'v1/{+name}', options)
259
261
  command.response_representation = Google::Apis::SecretmanagerV1::Secret::Representation
260
262
  command.response_class = Google::Apis::SecretmanagerV1::Secret
@@ -298,7 +300,7 @@ module Google
298
300
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
299
301
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
300
302
  # @raise [Google::Apis::AuthorizationError] Authorization is required
301
- def get_project_secret_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
303
+ def get_project_location_secret_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
302
304
  command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
303
305
  command.response_representation = Google::Apis::SecretmanagerV1::Policy::Representation
304
306
  command.response_class = Google::Apis::SecretmanagerV1::Policy
@@ -312,7 +314,7 @@ module Google
312
314
  # Lists Secrets.
313
315
  # @param [String] parent
314
316
  # Required. The resource name of the project associated with the Secrets, in the
315
- # format `projects/*`.
317
+ # format `projects/*` or `projects/*/locations/*`
316
318
  # @param [String] filter
317
319
  # Optional. Filter string, adhering to the rules in [List-operation filtering](
318
320
  # https://cloud.google.com/secret-manager/docs/filtering). List only secrets
@@ -341,7 +343,7 @@ module Google
341
343
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
342
344
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
343
345
  # @raise [Google::Apis::AuthorizationError] Authorization is required
344
- def list_project_secrets(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
346
+ def list_project_location_secrets(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
345
347
  command = make_simple_command(:get, 'v1/{+parent}/secrets', options)
346
348
  command.response_representation = Google::Apis::SecretmanagerV1::ListSecretsResponse::Representation
347
349
  command.response_class = Google::Apis::SecretmanagerV1::ListSecretsResponse
@@ -378,7 +380,7 @@ module Google
378
380
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
379
381
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
380
382
  # @raise [Google::Apis::AuthorizationError] Authorization is required
381
- def patch_project_secret(name, secret_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
383
+ def patch_project_location_secret(name, secret_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
382
384
  command = make_simple_command(:patch, 'v1/{+name}', options)
383
385
  command.request_representation = Google::Apis::SecretmanagerV1::Secret::Representation
384
386
  command.request_object = secret_object
@@ -416,7 +418,7 @@ module Google
416
418
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
417
419
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
418
420
  # @raise [Google::Apis::AuthorizationError] Authorization is required
419
- def set_secret_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
421
+ def set_project_location_secret_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
420
422
  command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
421
423
  command.request_representation = Google::Apis::SecretmanagerV1::SetIamPolicyRequest::Representation
422
424
  command.request_object = set_iam_policy_request_object
@@ -455,7 +457,7 @@ module Google
455
457
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
456
458
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
457
459
  # @raise [Google::Apis::AuthorizationError] Authorization is required
458
- def test_secret_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
460
+ def test_project_location_secret_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
459
461
  command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
460
462
  command.request_representation = Google::Apis::SecretmanagerV1::TestIamPermissionsRequest::Representation
461
463
  command.request_object = test_iam_permissions_request_object
@@ -472,8 +474,9 @@ module Google
472
474
  # SecretVersion.
473
475
  # @param [String] name
474
476
  # Required. The resource name of the SecretVersion in the format `projects/*/
475
- # secrets/*/versions/*`. `projects/*/secrets/*/versions/latest` is an alias to
476
- # the most recently created SecretVersion.
477
+ # secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*`. `
478
+ # projects/*/secrets/*/versions/latest` or `projects/*/locations/*/secrets/*/
479
+ # versions/latest` is an alias to the most recently created SecretVersion.
477
480
  # @param [String] fields
478
481
  # Selector specifying which fields to include in a partial response.
479
482
  # @param [String] quota_user
@@ -491,7 +494,7 @@ module Google
491
494
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
492
495
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
493
496
  # @raise [Google::Apis::AuthorizationError] Authorization is required
494
- def access_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
497
+ def access_project_location_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
495
498
  command = make_simple_command(:get, 'v1/{+name}:access', options)
496
499
  command.response_representation = Google::Apis::SecretmanagerV1::AccessSecretVersionResponse::Representation
497
500
  command.response_class = Google::Apis::SecretmanagerV1::AccessSecretVersionResponse
@@ -505,7 +508,8 @@ module Google
505
508
  # irrevocably destroys the secret data.
506
509
  # @param [String] name
507
510
  # Required. The resource name of the SecretVersion to destroy in the format `
508
- # projects/*/secrets/*/versions/*`.
511
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
512
+ # *`.
509
513
  # @param [Google::Apis::SecretmanagerV1::DestroySecretVersionRequest] destroy_secret_version_request_object
510
514
  # @param [String] fields
511
515
  # Selector specifying which fields to include in a partial response.
@@ -524,7 +528,7 @@ module Google
524
528
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
525
529
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
526
530
  # @raise [Google::Apis::AuthorizationError] Authorization is required
527
- def destroy_secret_version(name, destroy_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
531
+ def destroy_project_location_secret_version(name, destroy_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
528
532
  command = make_simple_command(:post, 'v1/{+name}:destroy', options)
529
533
  command.request_representation = Google::Apis::SecretmanagerV1::DestroySecretVersionRequest::Representation
530
534
  command.request_object = destroy_secret_version_request_object
@@ -539,7 +543,8 @@ module Google
539
543
  # Disables a SecretVersion. Sets the state of the SecretVersion to DISABLED.
540
544
  # @param [String] name
541
545
  # Required. The resource name of the SecretVersion to disable in the format `
542
- # projects/*/secrets/*/versions/*`.
546
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
547
+ # *`.
543
548
  # @param [Google::Apis::SecretmanagerV1::DisableSecretVersionRequest] disable_secret_version_request_object
544
549
  # @param [String] fields
545
550
  # Selector specifying which fields to include in a partial response.
@@ -558,7 +563,7 @@ module Google
558
563
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
559
564
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
560
565
  # @raise [Google::Apis::AuthorizationError] Authorization is required
561
- def disable_secret_version(name, disable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
566
+ def disable_project_location_secret_version(name, disable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
562
567
  command = make_simple_command(:post, 'v1/{+name}:disable', options)
563
568
  command.request_representation = Google::Apis::SecretmanagerV1::DisableSecretVersionRequest::Representation
564
569
  command.request_object = disable_secret_version_request_object
@@ -573,7 +578,8 @@ module Google
573
578
  # Enables a SecretVersion. Sets the state of the SecretVersion to ENABLED.
574
579
  # @param [String] name
575
580
  # Required. The resource name of the SecretVersion to enable in the format `
576
- # projects/*/secrets/*/versions/*`.
581
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
582
+ # *`.
577
583
  # @param [Google::Apis::SecretmanagerV1::EnableSecretVersionRequest] enable_secret_version_request_object
578
584
  # @param [String] fields
579
585
  # Selector specifying which fields to include in a partial response.
@@ -592,7 +598,7 @@ module Google
592
598
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
593
599
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
594
600
  # @raise [Google::Apis::AuthorizationError] Authorization is required
595
- def enable_secret_version(name, enable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
601
+ def enable_project_location_secret_version(name, enable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
596
602
  command = make_simple_command(:post, 'v1/{+name}:enable', options)
597
603
  command.request_representation = Google::Apis::SecretmanagerV1::EnableSecretVersionRequest::Representation
598
604
  command.request_object = enable_secret_version_request_object
@@ -608,8 +614,9 @@ module Google
608
614
  # an alias to the most recently created SecretVersion.
609
615
  # @param [String] name
610
616
  # Required. The resource name of the SecretVersion in the format `projects/*/
611
- # secrets/*/versions/*`. `projects/*/secrets/*/versions/latest` is an alias to
612
- # the most recently created SecretVersion.
617
+ # secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*`. `
618
+ # projects/*/secrets/*/versions/latest` or `projects/*/locations/*/secrets/*/
619
+ # versions/latest` is an alias to the most recently created SecretVersion.
613
620
  # @param [String] fields
614
621
  # Selector specifying which fields to include in a partial response.
615
622
  # @param [String] quota_user
@@ -627,7 +634,7 @@ module Google
627
634
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
628
635
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
629
636
  # @raise [Google::Apis::AuthorizationError] Authorization is required
630
- def get_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
637
+ def get_project_location_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
631
638
  command = make_simple_command(:get, 'v1/{+name}', options)
632
639
  command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
633
640
  command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
@@ -640,7 +647,574 @@ module Google
640
647
  # Lists SecretVersions. This call does not return secret data.
641
648
  # @param [String] parent
642
649
  # Required. The resource name of the Secret associated with the SecretVersions
643
- # to list, in the format `projects/*/secrets/*`.
650
+ # to list, in the format `projects/*/secrets/*` or `projects/*/locations/*/
651
+ # secrets/*`.
652
+ # @param [String] filter
653
+ # Optional. Filter string, adhering to the rules in [List-operation filtering](
654
+ # https://cloud.google.com/secret-manager/docs/filtering). List only secret
655
+ # versions matching the filter. If filter is empty, all secret versions are
656
+ # listed.
657
+ # @param [Fixnum] page_size
658
+ # Optional. The maximum number of results to be returned in a single page. If
659
+ # set to 0, the server decides the number of results to return. If the number is
660
+ # greater than 25000, it is capped at 25000.
661
+ # @param [String] page_token
662
+ # Optional. Pagination token, returned earlier via ListSecretVersionsResponse.
663
+ # next_page_token][].
664
+ # @param [String] fields
665
+ # Selector specifying which fields to include in a partial response.
666
+ # @param [String] quota_user
667
+ # Available to use for quota purposes for server-side applications. Can be any
668
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
669
+ # @param [Google::Apis::RequestOptions] options
670
+ # Request-specific options
671
+ #
672
+ # @yield [result, err] Result & error if block supplied
673
+ # @yieldparam result [Google::Apis::SecretmanagerV1::ListSecretVersionsResponse] parsed result object
674
+ # @yieldparam err [StandardError] error object if request failed
675
+ #
676
+ # @return [Google::Apis::SecretmanagerV1::ListSecretVersionsResponse]
677
+ #
678
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
679
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
680
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
681
+ def list_project_location_secret_versions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
682
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
683
+ command.response_representation = Google::Apis::SecretmanagerV1::ListSecretVersionsResponse::Representation
684
+ command.response_class = Google::Apis::SecretmanagerV1::ListSecretVersionsResponse
685
+ command.params['parent'] = parent unless parent.nil?
686
+ command.query['filter'] = filter unless filter.nil?
687
+ command.query['pageSize'] = page_size unless page_size.nil?
688
+ command.query['pageToken'] = page_token unless page_token.nil?
689
+ command.query['fields'] = fields unless fields.nil?
690
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
691
+ execute_or_queue_command(command, &block)
692
+ end
693
+
694
+ # Creates a new SecretVersion containing secret data and attaches it to an
695
+ # existing Secret.
696
+ # @param [String] parent
697
+ # Required. The resource name of the Secret to associate with the SecretVersion
698
+ # in the format `projects/*/secrets/*` or `projects/*/locations/*/secrets/*`.
699
+ # @param [Google::Apis::SecretmanagerV1::AddSecretVersionRequest] add_secret_version_request_object
700
+ # @param [String] fields
701
+ # Selector specifying which fields to include in a partial response.
702
+ # @param [String] quota_user
703
+ # Available to use for quota purposes for server-side applications. Can be any
704
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
705
+ # @param [Google::Apis::RequestOptions] options
706
+ # Request-specific options
707
+ #
708
+ # @yield [result, err] Result & error if block supplied
709
+ # @yieldparam result [Google::Apis::SecretmanagerV1::SecretVersion] parsed result object
710
+ # @yieldparam err [StandardError] error object if request failed
711
+ #
712
+ # @return [Google::Apis::SecretmanagerV1::SecretVersion]
713
+ #
714
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
715
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
716
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
717
+ def add_project_secret_version(parent, add_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
718
+ command = make_simple_command(:post, 'v1/{+parent}:addVersion', options)
719
+ command.request_representation = Google::Apis::SecretmanagerV1::AddSecretVersionRequest::Representation
720
+ command.request_object = add_secret_version_request_object
721
+ command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
722
+ command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
723
+ command.params['parent'] = parent unless parent.nil?
724
+ command.query['fields'] = fields unless fields.nil?
725
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
726
+ execute_or_queue_command(command, &block)
727
+ end
728
+
729
+ # Creates a new Secret containing no SecretVersions.
730
+ # @param [String] parent
731
+ # Required. The resource name of the project to associate with the Secret, in
732
+ # the format `projects/*` or `projects/*/locations/*`.
733
+ # @param [Google::Apis::SecretmanagerV1::Secret] secret_object
734
+ # @param [String] secret_id
735
+ # Required. This must be unique within the project. A secret ID is a string with
736
+ # a maximum length of 255 characters and can contain uppercase and lowercase
737
+ # letters, numerals, and the hyphen (`-`) and underscore (`_`) characters.
738
+ # @param [String] fields
739
+ # Selector specifying which fields to include in a partial response.
740
+ # @param [String] quota_user
741
+ # Available to use for quota purposes for server-side applications. Can be any
742
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
743
+ # @param [Google::Apis::RequestOptions] options
744
+ # Request-specific options
745
+ #
746
+ # @yield [result, err] Result & error if block supplied
747
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Secret] parsed result object
748
+ # @yieldparam err [StandardError] error object if request failed
749
+ #
750
+ # @return [Google::Apis::SecretmanagerV1::Secret]
751
+ #
752
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
753
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
754
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
755
+ def create_project_secret(parent, secret_object = nil, secret_id: nil, fields: nil, quota_user: nil, options: nil, &block)
756
+ command = make_simple_command(:post, 'v1/{+parent}/secrets', options)
757
+ command.request_representation = Google::Apis::SecretmanagerV1::Secret::Representation
758
+ command.request_object = secret_object
759
+ command.response_representation = Google::Apis::SecretmanagerV1::Secret::Representation
760
+ command.response_class = Google::Apis::SecretmanagerV1::Secret
761
+ command.params['parent'] = parent unless parent.nil?
762
+ command.query['secretId'] = secret_id unless secret_id.nil?
763
+ command.query['fields'] = fields unless fields.nil?
764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
765
+ execute_or_queue_command(command, &block)
766
+ end
767
+
768
+ # Deletes a Secret.
769
+ # @param [String] name
770
+ # Required. The resource name of the Secret to delete in the format `projects/*/
771
+ # secrets/*`.
772
+ # @param [String] etag
773
+ # Optional. Etag of the Secret. The request succeeds if it matches the etag of
774
+ # the currently stored secret object. If the etag is omitted, the request
775
+ # succeeds.
776
+ # @param [String] fields
777
+ # Selector specifying which fields to include in a partial response.
778
+ # @param [String] quota_user
779
+ # Available to use for quota purposes for server-side applications. Can be any
780
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
781
+ # @param [Google::Apis::RequestOptions] options
782
+ # Request-specific options
783
+ #
784
+ # @yield [result, err] Result & error if block supplied
785
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Empty] parsed result object
786
+ # @yieldparam err [StandardError] error object if request failed
787
+ #
788
+ # @return [Google::Apis::SecretmanagerV1::Empty]
789
+ #
790
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
791
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
792
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
793
+ def delete_project_secret(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
794
+ command = make_simple_command(:delete, 'v1/{+name}', options)
795
+ command.response_representation = Google::Apis::SecretmanagerV1::Empty::Representation
796
+ command.response_class = Google::Apis::SecretmanagerV1::Empty
797
+ command.params['name'] = name unless name.nil?
798
+ command.query['etag'] = etag unless etag.nil?
799
+ command.query['fields'] = fields unless fields.nil?
800
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
801
+ execute_or_queue_command(command, &block)
802
+ end
803
+
804
+ # Gets metadata for a given Secret.
805
+ # @param [String] name
806
+ # Required. The resource name of the Secret, in the format `projects/*/secrets/*`
807
+ # or `projects/*/locations/*/secrets/*`.
808
+ # @param [String] fields
809
+ # Selector specifying which fields to include in a partial response.
810
+ # @param [String] quota_user
811
+ # Available to use for quota purposes for server-side applications. Can be any
812
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
813
+ # @param [Google::Apis::RequestOptions] options
814
+ # Request-specific options
815
+ #
816
+ # @yield [result, err] Result & error if block supplied
817
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Secret] parsed result object
818
+ # @yieldparam err [StandardError] error object if request failed
819
+ #
820
+ # @return [Google::Apis::SecretmanagerV1::Secret]
821
+ #
822
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
823
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
824
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
825
+ def get_project_secret(name, fields: nil, quota_user: nil, options: nil, &block)
826
+ command = make_simple_command(:get, 'v1/{+name}', options)
827
+ command.response_representation = Google::Apis::SecretmanagerV1::Secret::Representation
828
+ command.response_class = Google::Apis::SecretmanagerV1::Secret
829
+ command.params['name'] = name unless name.nil?
830
+ command.query['fields'] = fields unless fields.nil?
831
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
832
+ execute_or_queue_command(command, &block)
833
+ end
834
+
835
+ # Gets the access control policy for a secret. Returns empty policy if the
836
+ # secret exists and does not have a policy set.
837
+ # @param [String] resource
838
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
839
+ # names](https://cloud.google.com/apis/design/resource_names) for the
840
+ # appropriate value for this field.
841
+ # @param [Fixnum] options_requested_policy_version
842
+ # Optional. The maximum policy version that will be used to format the policy.
843
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
844
+ # rejected. Requests for policies with any conditional role bindings must
845
+ # specify version 3. Policies with no conditional role bindings may specify any
846
+ # valid value or leave the field unset. The policy in the response might use the
847
+ # policy version that you specified, or it might use a lower policy version. For
848
+ # example, if you specify version 3, but the policy has no conditional role
849
+ # bindings, the response uses version 1. To learn which resources support
850
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
851
+ # google.com/iam/help/conditions/resource-policies).
852
+ # @param [String] fields
853
+ # Selector specifying which fields to include in a partial response.
854
+ # @param [String] quota_user
855
+ # Available to use for quota purposes for server-side applications. Can be any
856
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
857
+ # @param [Google::Apis::RequestOptions] options
858
+ # Request-specific options
859
+ #
860
+ # @yield [result, err] Result & error if block supplied
861
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Policy] parsed result object
862
+ # @yieldparam err [StandardError] error object if request failed
863
+ #
864
+ # @return [Google::Apis::SecretmanagerV1::Policy]
865
+ #
866
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
867
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
868
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
869
+ def get_project_secret_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
870
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
871
+ command.response_representation = Google::Apis::SecretmanagerV1::Policy::Representation
872
+ command.response_class = Google::Apis::SecretmanagerV1::Policy
873
+ command.params['resource'] = resource unless resource.nil?
874
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
875
+ command.query['fields'] = fields unless fields.nil?
876
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
877
+ execute_or_queue_command(command, &block)
878
+ end
879
+
880
+ # Lists Secrets.
881
+ # @param [String] parent
882
+ # Required. The resource name of the project associated with the Secrets, in the
883
+ # format `projects/*` or `projects/*/locations/*`
884
+ # @param [String] filter
885
+ # Optional. Filter string, adhering to the rules in [List-operation filtering](
886
+ # https://cloud.google.com/secret-manager/docs/filtering). List only secrets
887
+ # matching the filter. If filter is empty, all secrets are listed.
888
+ # @param [Fixnum] page_size
889
+ # Optional. The maximum number of results to be returned in a single page. If
890
+ # set to 0, the server decides the number of results to return. If the number is
891
+ # greater than 25000, it is capped at 25000.
892
+ # @param [String] page_token
893
+ # Optional. Pagination token, returned earlier via ListSecretsResponse.
894
+ # next_page_token.
895
+ # @param [String] fields
896
+ # Selector specifying which fields to include in a partial response.
897
+ # @param [String] quota_user
898
+ # Available to use for quota purposes for server-side applications. Can be any
899
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
900
+ # @param [Google::Apis::RequestOptions] options
901
+ # Request-specific options
902
+ #
903
+ # @yield [result, err] Result & error if block supplied
904
+ # @yieldparam result [Google::Apis::SecretmanagerV1::ListSecretsResponse] parsed result object
905
+ # @yieldparam err [StandardError] error object if request failed
906
+ #
907
+ # @return [Google::Apis::SecretmanagerV1::ListSecretsResponse]
908
+ #
909
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
910
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
911
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
912
+ def list_project_secrets(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
913
+ command = make_simple_command(:get, 'v1/{+parent}/secrets', options)
914
+ command.response_representation = Google::Apis::SecretmanagerV1::ListSecretsResponse::Representation
915
+ command.response_class = Google::Apis::SecretmanagerV1::ListSecretsResponse
916
+ command.params['parent'] = parent unless parent.nil?
917
+ command.query['filter'] = filter unless filter.nil?
918
+ command.query['pageSize'] = page_size unless page_size.nil?
919
+ command.query['pageToken'] = page_token unless page_token.nil?
920
+ command.query['fields'] = fields unless fields.nil?
921
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
922
+ execute_or_queue_command(command, &block)
923
+ end
924
+
925
+ # Updates metadata of an existing Secret.
926
+ # @param [String] name
927
+ # Output only. The resource name of the Secret in the format `projects/*/secrets/
928
+ # *`.
929
+ # @param [Google::Apis::SecretmanagerV1::Secret] secret_object
930
+ # @param [String] update_mask
931
+ # Required. Specifies the fields to be updated.
932
+ # @param [String] fields
933
+ # Selector specifying which fields to include in a partial response.
934
+ # @param [String] quota_user
935
+ # Available to use for quota purposes for server-side applications. Can be any
936
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
937
+ # @param [Google::Apis::RequestOptions] options
938
+ # Request-specific options
939
+ #
940
+ # @yield [result, err] Result & error if block supplied
941
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Secret] parsed result object
942
+ # @yieldparam err [StandardError] error object if request failed
943
+ #
944
+ # @return [Google::Apis::SecretmanagerV1::Secret]
945
+ #
946
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
947
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
948
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
949
+ def patch_project_secret(name, secret_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
950
+ command = make_simple_command(:patch, 'v1/{+name}', options)
951
+ command.request_representation = Google::Apis::SecretmanagerV1::Secret::Representation
952
+ command.request_object = secret_object
953
+ command.response_representation = Google::Apis::SecretmanagerV1::Secret::Representation
954
+ command.response_class = Google::Apis::SecretmanagerV1::Secret
955
+ command.params['name'] = name unless name.nil?
956
+ command.query['updateMask'] = update_mask unless update_mask.nil?
957
+ command.query['fields'] = fields unless fields.nil?
958
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
959
+ execute_or_queue_command(command, &block)
960
+ end
961
+
962
+ # Sets the access control policy on the specified secret. Replaces any existing
963
+ # policy. Permissions on SecretVersions are enforced according to the policy set
964
+ # on the associated Secret.
965
+ # @param [String] resource
966
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
967
+ # names](https://cloud.google.com/apis/design/resource_names) for the
968
+ # appropriate value for this field.
969
+ # @param [Google::Apis::SecretmanagerV1::SetIamPolicyRequest] set_iam_policy_request_object
970
+ # @param [String] fields
971
+ # Selector specifying which fields to include in a partial response.
972
+ # @param [String] quota_user
973
+ # Available to use for quota purposes for server-side applications. Can be any
974
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
975
+ # @param [Google::Apis::RequestOptions] options
976
+ # Request-specific options
977
+ #
978
+ # @yield [result, err] Result & error if block supplied
979
+ # @yieldparam result [Google::Apis::SecretmanagerV1::Policy] parsed result object
980
+ # @yieldparam err [StandardError] error object if request failed
981
+ #
982
+ # @return [Google::Apis::SecretmanagerV1::Policy]
983
+ #
984
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
985
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
986
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
987
+ def set_secret_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
988
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
989
+ command.request_representation = Google::Apis::SecretmanagerV1::SetIamPolicyRequest::Representation
990
+ command.request_object = set_iam_policy_request_object
991
+ command.response_representation = Google::Apis::SecretmanagerV1::Policy::Representation
992
+ command.response_class = Google::Apis::SecretmanagerV1::Policy
993
+ command.params['resource'] = resource unless resource.nil?
994
+ command.query['fields'] = fields unless fields.nil?
995
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
996
+ execute_or_queue_command(command, &block)
997
+ end
998
+
999
+ # Returns permissions that a caller has for the specified secret. If the secret
1000
+ # does not exist, this call returns an empty set of permissions, not a NOT_FOUND
1001
+ # error. Note: This operation is designed to be used for building permission-
1002
+ # aware UIs and command-line tools, not for authorization checking. This
1003
+ # operation may "fail open" without warning.
1004
+ # @param [String] resource
1005
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1006
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1007
+ # appropriate value for this field.
1008
+ # @param [Google::Apis::SecretmanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1009
+ # @param [String] fields
1010
+ # Selector specifying which fields to include in a partial response.
1011
+ # @param [String] quota_user
1012
+ # Available to use for quota purposes for server-side applications. Can be any
1013
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1014
+ # @param [Google::Apis::RequestOptions] options
1015
+ # Request-specific options
1016
+ #
1017
+ # @yield [result, err] Result & error if block supplied
1018
+ # @yieldparam result [Google::Apis::SecretmanagerV1::TestIamPermissionsResponse] parsed result object
1019
+ # @yieldparam err [StandardError] error object if request failed
1020
+ #
1021
+ # @return [Google::Apis::SecretmanagerV1::TestIamPermissionsResponse]
1022
+ #
1023
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1024
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1025
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1026
+ def test_secret_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1027
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1028
+ command.request_representation = Google::Apis::SecretmanagerV1::TestIamPermissionsRequest::Representation
1029
+ command.request_object = test_iam_permissions_request_object
1030
+ command.response_representation = Google::Apis::SecretmanagerV1::TestIamPermissionsResponse::Representation
1031
+ command.response_class = Google::Apis::SecretmanagerV1::TestIamPermissionsResponse
1032
+ command.params['resource'] = resource unless resource.nil?
1033
+ command.query['fields'] = fields unless fields.nil?
1034
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1035
+ execute_or_queue_command(command, &block)
1036
+ end
1037
+
1038
+ # Accesses a SecretVersion. This call returns the secret data. `projects/*/
1039
+ # secrets/*/versions/latest` is an alias to the most recently created
1040
+ # SecretVersion.
1041
+ # @param [String] name
1042
+ # Required. The resource name of the SecretVersion in the format `projects/*/
1043
+ # secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*`. `
1044
+ # projects/*/secrets/*/versions/latest` or `projects/*/locations/*/secrets/*/
1045
+ # versions/latest` is an alias to the most recently created SecretVersion.
1046
+ # @param [String] fields
1047
+ # Selector specifying which fields to include in a partial response.
1048
+ # @param [String] quota_user
1049
+ # Available to use for quota purposes for server-side applications. Can be any
1050
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1051
+ # @param [Google::Apis::RequestOptions] options
1052
+ # Request-specific options
1053
+ #
1054
+ # @yield [result, err] Result & error if block supplied
1055
+ # @yieldparam result [Google::Apis::SecretmanagerV1::AccessSecretVersionResponse] parsed result object
1056
+ # @yieldparam err [StandardError] error object if request failed
1057
+ #
1058
+ # @return [Google::Apis::SecretmanagerV1::AccessSecretVersionResponse]
1059
+ #
1060
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1061
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1062
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1063
+ def access_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
1064
+ command = make_simple_command(:get, 'v1/{+name}:access', options)
1065
+ command.response_representation = Google::Apis::SecretmanagerV1::AccessSecretVersionResponse::Representation
1066
+ command.response_class = Google::Apis::SecretmanagerV1::AccessSecretVersionResponse
1067
+ command.params['name'] = name unless name.nil?
1068
+ command.query['fields'] = fields unless fields.nil?
1069
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1070
+ execute_or_queue_command(command, &block)
1071
+ end
1072
+
1073
+ # Destroys a SecretVersion. Sets the state of the SecretVersion to DESTROYED and
1074
+ # irrevocably destroys the secret data.
1075
+ # @param [String] name
1076
+ # Required. The resource name of the SecretVersion to destroy in the format `
1077
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
1078
+ # *`.
1079
+ # @param [Google::Apis::SecretmanagerV1::DestroySecretVersionRequest] destroy_secret_version_request_object
1080
+ # @param [String] fields
1081
+ # Selector specifying which fields to include in a partial response.
1082
+ # @param [String] quota_user
1083
+ # Available to use for quota purposes for server-side applications. Can be any
1084
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1085
+ # @param [Google::Apis::RequestOptions] options
1086
+ # Request-specific options
1087
+ #
1088
+ # @yield [result, err] Result & error if block supplied
1089
+ # @yieldparam result [Google::Apis::SecretmanagerV1::SecretVersion] parsed result object
1090
+ # @yieldparam err [StandardError] error object if request failed
1091
+ #
1092
+ # @return [Google::Apis::SecretmanagerV1::SecretVersion]
1093
+ #
1094
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1095
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1096
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1097
+ def destroy_secret_version(name, destroy_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1098
+ command = make_simple_command(:post, 'v1/{+name}:destroy', options)
1099
+ command.request_representation = Google::Apis::SecretmanagerV1::DestroySecretVersionRequest::Representation
1100
+ command.request_object = destroy_secret_version_request_object
1101
+ command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
1102
+ command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
1103
+ command.params['name'] = name unless name.nil?
1104
+ command.query['fields'] = fields unless fields.nil?
1105
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1106
+ execute_or_queue_command(command, &block)
1107
+ end
1108
+
1109
+ # Disables a SecretVersion. Sets the state of the SecretVersion to DISABLED.
1110
+ # @param [String] name
1111
+ # Required. The resource name of the SecretVersion to disable in the format `
1112
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
1113
+ # *`.
1114
+ # @param [Google::Apis::SecretmanagerV1::DisableSecretVersionRequest] disable_secret_version_request_object
1115
+ # @param [String] fields
1116
+ # Selector specifying which fields to include in a partial response.
1117
+ # @param [String] quota_user
1118
+ # Available to use for quota purposes for server-side applications. Can be any
1119
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1120
+ # @param [Google::Apis::RequestOptions] options
1121
+ # Request-specific options
1122
+ #
1123
+ # @yield [result, err] Result & error if block supplied
1124
+ # @yieldparam result [Google::Apis::SecretmanagerV1::SecretVersion] parsed result object
1125
+ # @yieldparam err [StandardError] error object if request failed
1126
+ #
1127
+ # @return [Google::Apis::SecretmanagerV1::SecretVersion]
1128
+ #
1129
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1130
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1131
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1132
+ def disable_secret_version(name, disable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1133
+ command = make_simple_command(:post, 'v1/{+name}:disable', options)
1134
+ command.request_representation = Google::Apis::SecretmanagerV1::DisableSecretVersionRequest::Representation
1135
+ command.request_object = disable_secret_version_request_object
1136
+ command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
1137
+ command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
1138
+ command.params['name'] = name unless name.nil?
1139
+ command.query['fields'] = fields unless fields.nil?
1140
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1141
+ execute_or_queue_command(command, &block)
1142
+ end
1143
+
1144
+ # Enables a SecretVersion. Sets the state of the SecretVersion to ENABLED.
1145
+ # @param [String] name
1146
+ # Required. The resource name of the SecretVersion to enable in the format `
1147
+ # projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/
1148
+ # *`.
1149
+ # @param [Google::Apis::SecretmanagerV1::EnableSecretVersionRequest] enable_secret_version_request_object
1150
+ # @param [String] fields
1151
+ # Selector specifying which fields to include in a partial response.
1152
+ # @param [String] quota_user
1153
+ # Available to use for quota purposes for server-side applications. Can be any
1154
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1155
+ # @param [Google::Apis::RequestOptions] options
1156
+ # Request-specific options
1157
+ #
1158
+ # @yield [result, err] Result & error if block supplied
1159
+ # @yieldparam result [Google::Apis::SecretmanagerV1::SecretVersion] parsed result object
1160
+ # @yieldparam err [StandardError] error object if request failed
1161
+ #
1162
+ # @return [Google::Apis::SecretmanagerV1::SecretVersion]
1163
+ #
1164
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1165
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1166
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1167
+ def enable_secret_version(name, enable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1168
+ command = make_simple_command(:post, 'v1/{+name}:enable', options)
1169
+ command.request_representation = Google::Apis::SecretmanagerV1::EnableSecretVersionRequest::Representation
1170
+ command.request_object = enable_secret_version_request_object
1171
+ command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
1172
+ command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
1173
+ command.params['name'] = name unless name.nil?
1174
+ command.query['fields'] = fields unless fields.nil?
1175
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1176
+ execute_or_queue_command(command, &block)
1177
+ end
1178
+
1179
+ # Gets metadata for a SecretVersion. `projects/*/secrets/*/versions/latest` is
1180
+ # an alias to the most recently created SecretVersion.
1181
+ # @param [String] name
1182
+ # Required. The resource name of the SecretVersion in the format `projects/*/
1183
+ # secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*`. `
1184
+ # projects/*/secrets/*/versions/latest` or `projects/*/locations/*/secrets/*/
1185
+ # versions/latest` is an alias to the most recently created SecretVersion.
1186
+ # @param [String] fields
1187
+ # Selector specifying which fields to include in a partial response.
1188
+ # @param [String] quota_user
1189
+ # Available to use for quota purposes for server-side applications. Can be any
1190
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1191
+ # @param [Google::Apis::RequestOptions] options
1192
+ # Request-specific options
1193
+ #
1194
+ # @yield [result, err] Result & error if block supplied
1195
+ # @yieldparam result [Google::Apis::SecretmanagerV1::SecretVersion] parsed result object
1196
+ # @yieldparam err [StandardError] error object if request failed
1197
+ #
1198
+ # @return [Google::Apis::SecretmanagerV1::SecretVersion]
1199
+ #
1200
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1201
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1202
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1203
+ def get_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
1204
+ command = make_simple_command(:get, 'v1/{+name}', options)
1205
+ command.response_representation = Google::Apis::SecretmanagerV1::SecretVersion::Representation
1206
+ command.response_class = Google::Apis::SecretmanagerV1::SecretVersion
1207
+ command.params['name'] = name unless name.nil?
1208
+ command.query['fields'] = fields unless fields.nil?
1209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1210
+ execute_or_queue_command(command, &block)
1211
+ end
1212
+
1213
+ # Lists SecretVersions. This call does not return secret data.
1214
+ # @param [String] parent
1215
+ # Required. The resource name of the Secret associated with the SecretVersions
1216
+ # to list, in the format `projects/*/secrets/*` or `projects/*/locations/*/
1217
+ # secrets/*`.
644
1218
  # @param [String] filter
645
1219
  # Optional. Filter string, adhering to the rules in [List-operation filtering](
646
1220
  # https://cloud.google.com/secret-manager/docs/filtering). List only secret
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-secretmanager_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.37.0
4
+ version: 0.39.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: 2023-12-24 00:00:00.000000000 Z
11
+ date: 2024-02-04 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.11.0
19
+ version: 0.12.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.11.0
29
+ version: 0.12.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-secretmanager_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-secretmanager_v1/v0.37.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-secretmanager_v1/v0.39.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-secretmanager_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.4.19
78
+ rubygems_version: 3.5.3
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Secret Manager API V1