google-cloud-secret_manager-v1 0.20.0 → 1.0.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.
@@ -19,6 +19,7 @@
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/secretmanager/v1/service_pb"
21
21
  require "google/cloud/secret_manager/v1/secret_manager_service/rest/service_stub"
22
+ require "google/cloud/location/rest"
22
23
 
23
24
  module Google
24
25
  module Cloud
@@ -38,6 +39,9 @@ module Google
38
39
  # * {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}
39
40
  #
40
41
  class Client
42
+ # @private
43
+ API_VERSION = ""
44
+
41
45
  # @private
42
46
  DEFAULT_ENDPOINT_TEMPLATE = "secretmanager.$UNIVERSE_DOMAIN$"
43
47
 
@@ -188,8 +192,23 @@ module Google
188
192
  universe_domain: @config.universe_domain,
189
193
  credentials: credentials
190
194
  )
195
+
196
+ @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
197
+ config.credentials = credentials
198
+ config.quota_project = @quota_project_id
199
+ config.endpoint = @secret_manager_service_stub.endpoint
200
+ config.universe_domain = @secret_manager_service_stub.universe_domain
201
+ config.bindings_override = @config.bindings_override
202
+ end
191
203
  end
192
204
 
205
+ ##
206
+ # Get the associated client for mix-in of the Locations.
207
+ #
208
+ # @return [Google::Cloud::Location::Locations::Rest::Client]
209
+ #
210
+ attr_reader :location_client
211
+
193
212
  # Service calls
194
213
 
195
214
  ##
@@ -212,7 +231,8 @@ module Google
212
231
  #
213
232
  # @param parent [::String]
214
233
  # Required. The resource name of the project associated with the
215
- # {::Google::Cloud::SecretManager::V1::Secret Secrets}, in the format `projects/*`.
234
+ # {::Google::Cloud::SecretManager::V1::Secret Secrets}, in the format `projects/*`
235
+ # or `projects/*/locations/*`
216
236
  # @param page_size [::Integer]
217
237
  # Optional. The maximum number of results to be returned in a single page. If
218
238
  # set to 0, the server decides the number of results to return. If the
@@ -264,12 +284,13 @@ module Google
264
284
  # Customize the options with defaults
265
285
  call_metadata = @config.rpcs.list_secrets.metadata.to_h
266
286
 
267
- # Set x-goog-api-client and x-goog-user-project headers
287
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
268
288
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
269
289
  lib_name: @config.lib_name, lib_version: @config.lib_version,
270
290
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
271
291
  transports_version_send: [:rest]
272
292
 
293
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
273
294
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
274
295
 
275
296
  options.apply_defaults timeout: @config.rpcs.list_secrets.timeout,
@@ -290,7 +311,8 @@ module Google
290
311
  end
291
312
 
292
313
  ##
293
- # Creates a new {::Google::Cloud::SecretManager::V1::Secret Secret} containing no {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions}.
314
+ # Creates a new {::Google::Cloud::SecretManager::V1::Secret Secret} containing no
315
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions}.
294
316
  #
295
317
  # @overload create_secret(request, options = nil)
296
318
  # Pass arguments to `create_secret` via a request object, either of type
@@ -309,7 +331,8 @@ module Google
309
331
  #
310
332
  # @param parent [::String]
311
333
  # Required. The resource name of the project to associate with the
312
- # {::Google::Cloud::SecretManager::V1::Secret Secret}, in the format `projects/*`.
334
+ # {::Google::Cloud::SecretManager::V1::Secret Secret}, in the format `projects/*`
335
+ # or `projects/*/locations/*`.
313
336
  # @param secret_id [::String]
314
337
  # Required. This must be unique within the project.
315
338
  #
@@ -317,7 +340,8 @@ module Google
317
340
  # contain uppercase and lowercase letters, numerals, and the hyphen (`-`) and
318
341
  # underscore (`_`) characters.
319
342
  # @param secret [::Google::Cloud::SecretManager::V1::Secret, ::Hash]
320
- # Required. A {::Google::Cloud::SecretManager::V1::Secret Secret} with initial field values.
343
+ # Required. A {::Google::Cloud::SecretManager::V1::Secret Secret} with initial
344
+ # field values.
321
345
  # @yield [result, operation] Access the result along with the TransportOperation object
322
346
  # @yieldparam result [::Google::Cloud::SecretManager::V1::Secret]
323
347
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -352,12 +376,13 @@ module Google
352
376
  # Customize the options with defaults
353
377
  call_metadata = @config.rpcs.create_secret.metadata.to_h
354
378
 
355
- # Set x-goog-api-client and x-goog-user-project headers
379
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
356
380
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
357
381
  lib_name: @config.lib_name, lib_version: @config.lib_version,
358
382
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
359
383
  transports_version_send: [:rest]
360
384
 
385
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
361
386
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
362
387
 
363
388
  options.apply_defaults timeout: @config.rpcs.create_secret.timeout,
@@ -377,8 +402,9 @@ module Google
377
402
  end
378
403
 
379
404
  ##
380
- # Creates a new {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} containing secret data and attaches
381
- # it to an existing {::Google::Cloud::SecretManager::V1::Secret Secret}.
405
+ # Creates a new {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}
406
+ # containing secret data and attaches it to an existing
407
+ # {::Google::Cloud::SecretManager::V1::Secret Secret}.
382
408
  #
383
409
  # @overload add_secret_version(request, options = nil)
384
410
  # Pass arguments to `add_secret_version` via a request object, either of type
@@ -396,10 +422,13 @@ module Google
396
422
  # the default parameter values, pass an empty Hash as a request object (see above).
397
423
  #
398
424
  # @param parent [::String]
399
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::Secret Secret} to associate with the
400
- # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format `projects/*/secrets/*`.
425
+ # Required. The resource name of the
426
+ # {::Google::Cloud::SecretManager::V1::Secret Secret} to associate with the
427
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format
428
+ # `projects/*/secrets/*` or `projects/*/locations/*/secrets/*`.
401
429
  # @param payload [::Google::Cloud::SecretManager::V1::SecretPayload, ::Hash]
402
- # Required. The secret payload of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
430
+ # Required. The secret payload of the
431
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
403
432
  # @yield [result, operation] Access the result along with the TransportOperation object
404
433
  # @yieldparam result [::Google::Cloud::SecretManager::V1::SecretVersion]
405
434
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -434,12 +463,13 @@ module Google
434
463
  # Customize the options with defaults
435
464
  call_metadata = @config.rpcs.add_secret_version.metadata.to_h
436
465
 
437
- # Set x-goog-api-client and x-goog-user-project headers
466
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
438
467
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
439
468
  lib_name: @config.lib_name, lib_version: @config.lib_version,
440
469
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
441
470
  transports_version_send: [:rest]
442
471
 
472
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
443
473
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
444
474
 
445
475
  options.apply_defaults timeout: @config.rpcs.add_secret_version.timeout,
@@ -477,7 +507,9 @@ module Google
477
507
  # the default parameter values, pass an empty Hash as a request object (see above).
478
508
  #
479
509
  # @param name [::String]
480
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::Secret Secret}, in the format `projects/*/secrets/*`.
510
+ # Required. The resource name of the
511
+ # {::Google::Cloud::SecretManager::V1::Secret Secret}, in the format
512
+ # `projects/*/secrets/*` or `projects/*/locations/*/secrets/*`.
481
513
  # @yield [result, operation] Access the result along with the TransportOperation object
482
514
  # @yieldparam result [::Google::Cloud::SecretManager::V1::Secret]
483
515
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -512,12 +544,13 @@ module Google
512
544
  # Customize the options with defaults
513
545
  call_metadata = @config.rpcs.get_secret.metadata.to_h
514
546
 
515
- # Set x-goog-api-client and x-goog-user-project headers
547
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
516
548
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
517
549
  lib_name: @config.lib_name, lib_version: @config.lib_version,
518
550
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
519
551
  transports_version_send: [:rest]
520
552
 
553
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
521
554
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
522
555
 
523
556
  options.apply_defaults timeout: @config.rpcs.get_secret.timeout,
@@ -537,7 +570,8 @@ module Google
537
570
  end
538
571
 
539
572
  ##
540
- # Updates metadata of an existing {::Google::Cloud::SecretManager::V1::Secret Secret}.
573
+ # Updates metadata of an existing
574
+ # {::Google::Cloud::SecretManager::V1::Secret Secret}.
541
575
  #
542
576
  # @overload update_secret(request, options = nil)
543
577
  # Pass arguments to `update_secret` via a request object, either of type
@@ -555,7 +589,8 @@ module Google
555
589
  # the default parameter values, pass an empty Hash as a request object (see above).
556
590
  #
557
591
  # @param secret [::Google::Cloud::SecretManager::V1::Secret, ::Hash]
558
- # Required. {::Google::Cloud::SecretManager::V1::Secret Secret} with updated field values.
592
+ # Required. {::Google::Cloud::SecretManager::V1::Secret Secret} with updated field
593
+ # values.
559
594
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
560
595
  # Required. Specifies the fields to be updated.
561
596
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -592,12 +627,13 @@ module Google
592
627
  # Customize the options with defaults
593
628
  call_metadata = @config.rpcs.update_secret.metadata.to_h
594
629
 
595
- # Set x-goog-api-client and x-goog-user-project headers
630
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
596
631
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
597
632
  lib_name: @config.lib_name, lib_version: @config.lib_version,
598
633
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
599
634
  transports_version_send: [:rest]
600
635
 
636
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
601
637
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
602
638
 
603
639
  options.apply_defaults timeout: @config.rpcs.update_secret.timeout,
@@ -635,12 +671,13 @@ module Google
635
671
  # the default parameter values, pass an empty Hash as a request object (see above).
636
672
  #
637
673
  # @param name [::String]
638
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::Secret Secret} to delete in the format
674
+ # Required. The resource name of the
675
+ # {::Google::Cloud::SecretManager::V1::Secret Secret} to delete in the format
639
676
  # `projects/*/secrets/*`.
640
677
  # @param etag [::String]
641
- # Optional. Etag of the {::Google::Cloud::SecretManager::V1::Secret Secret}. The request succeeds if it matches
642
- # the etag of the currently stored secret object. If the etag is omitted,
643
- # the request succeeds.
678
+ # Optional. Etag of the {::Google::Cloud::SecretManager::V1::Secret Secret}. The
679
+ # request succeeds if it matches the etag of the currently stored secret
680
+ # object. If the etag is omitted, the request succeeds.
644
681
  # @yield [result, operation] Access the result along with the TransportOperation object
645
682
  # @yieldparam result [::Google::Protobuf::Empty]
646
683
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -675,12 +712,13 @@ module Google
675
712
  # Customize the options with defaults
676
713
  call_metadata = @config.rpcs.delete_secret.metadata.to_h
677
714
 
678
- # Set x-goog-api-client and x-goog-user-project headers
715
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
679
716
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
680
717
  lib_name: @config.lib_name, lib_version: @config.lib_version,
681
718
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
682
719
  transports_version_send: [:rest]
683
720
 
721
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
684
722
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
685
723
 
686
724
  options.apply_defaults timeout: @config.rpcs.delete_secret.timeout,
@@ -700,8 +738,8 @@ module Google
700
738
  end
701
739
 
702
740
  ##
703
- # Lists {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions}. This call does not return secret
704
- # data.
741
+ # Lists {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions}. This
742
+ # call does not return secret data.
705
743
  #
706
744
  # @overload list_secret_versions(request, options = nil)
707
745
  # Pass arguments to `list_secret_versions` via a request object, either of type
@@ -719,9 +757,10 @@ module Google
719
757
  # the default parameter values, pass an empty Hash as a request object (see above).
720
758
  #
721
759
  # @param parent [::String]
722
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::Secret Secret} associated with the
723
- # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions} to list, in the format
724
- # `projects/*/secrets/*`.
760
+ # Required. The resource name of the
761
+ # {::Google::Cloud::SecretManager::V1::Secret Secret} associated with the
762
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions} to list, in
763
+ # the format `projects/*/secrets/*` or `projects/*/locations/*/secrets/*`.
725
764
  # @param page_size [::Integer]
726
765
  # Optional. The maximum number of results to be returned in a single page. If
727
766
  # set to 0, the server decides the number of results to return. If the
@@ -773,12 +812,13 @@ module Google
773
812
  # Customize the options with defaults
774
813
  call_metadata = @config.rpcs.list_secret_versions.metadata.to_h
775
814
 
776
- # Set x-goog-api-client and x-goog-user-project headers
815
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
777
816
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
778
817
  lib_name: @config.lib_name, lib_version: @config.lib_version,
779
818
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
780
819
  transports_version_send: [:rest]
781
820
 
821
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
782
822
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
783
823
 
784
824
  options.apply_defaults timeout: @config.rpcs.list_secret_versions.timeout,
@@ -799,7 +839,8 @@ module Google
799
839
  end
800
840
 
801
841
  ##
802
- # Gets metadata for a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
842
+ # Gets metadata for a
843
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
803
844
  #
804
845
  # `projects/*/secrets/*/versions/latest` is an alias to the most recently
805
846
  # created {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
@@ -820,11 +861,15 @@ module Google
820
861
  # the default parameter values, pass an empty Hash as a request object (see above).
821
862
  #
822
863
  # @param name [::String]
823
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format
824
- # `projects/*/secrets/*/versions/*`.
825
- #
826
- # `projects/*/secrets/*/versions/latest` is an alias to the most recently
827
- # created {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
864
+ # Required. The resource name of the
865
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format
866
+ # `projects/*/secrets/*/versions/*` or
867
+ # `projects/*/locations/*/secrets/*/versions/*`.
868
+ #
869
+ # `projects/*/secrets/*/versions/latest` or
870
+ # `projects/*/locations/*/secrets/*/versions/latest` is an alias to the most
871
+ # recently created
872
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
828
873
  # @yield [result, operation] Access the result along with the TransportOperation object
829
874
  # @yieldparam result [::Google::Cloud::SecretManager::V1::SecretVersion]
830
875
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -859,12 +904,13 @@ module Google
859
904
  # Customize the options with defaults
860
905
  call_metadata = @config.rpcs.get_secret_version.metadata.to_h
861
906
 
862
- # Set x-goog-api-client and x-goog-user-project headers
907
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
863
908
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
864
909
  lib_name: @config.lib_name, lib_version: @config.lib_version,
865
910
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
866
911
  transports_version_send: [:rest]
867
912
 
913
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
868
914
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
869
915
 
870
916
  options.apply_defaults timeout: @config.rpcs.get_secret_version.timeout,
@@ -884,7 +930,8 @@ module Google
884
930
  end
885
931
 
886
932
  ##
887
- # Accesses a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. This call returns the secret data.
933
+ # Accesses a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
934
+ # This call returns the secret data.
888
935
  #
889
936
  # `projects/*/secrets/*/versions/latest` is an alias to the most recently
890
937
  # created {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
@@ -905,11 +952,15 @@ module Google
905
952
  # the default parameter values, pass an empty Hash as a request object (see above).
906
953
  #
907
954
  # @param name [::String]
908
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format
909
- # `projects/*/secrets/*/versions/*`.
910
- #
911
- # `projects/*/secrets/*/versions/latest` is an alias to the most recently
912
- # created {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
955
+ # Required. The resource name of the
956
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} in the format
957
+ # `projects/*/secrets/*/versions/*` or
958
+ # `projects/*/locations/*/secrets/*/versions/*`.
959
+ #
960
+ # `projects/*/secrets/*/versions/latest` or
961
+ # `projects/*/locations/*/secrets/*/versions/latest` is an alias to the most
962
+ # recently created
963
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
913
964
  # @yield [result, operation] Access the result along with the TransportOperation object
914
965
  # @yieldparam result [::Google::Cloud::SecretManager::V1::AccessSecretVersionResponse]
915
966
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -944,12 +995,13 @@ module Google
944
995
  # Customize the options with defaults
945
996
  call_metadata = @config.rpcs.access_secret_version.metadata.to_h
946
997
 
947
- # Set x-goog-api-client and x-goog-user-project headers
998
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
948
999
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
949
1000
  lib_name: @config.lib_name, lib_version: @config.lib_version,
950
1001
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
951
1002
  transports_version_send: [:rest]
952
1003
 
1004
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
953
1005
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
954
1006
 
955
1007
  options.apply_defaults timeout: @config.rpcs.access_secret_version.timeout,
@@ -971,7 +1023,8 @@ module Google
971
1023
  ##
972
1024
  # Disables a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
973
1025
  #
974
- # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
1026
+ # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the
1027
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
975
1028
  # {::Google::Cloud::SecretManager::V1::SecretVersion::State::DISABLED DISABLED}.
976
1029
  #
977
1030
  # @overload disable_secret_version(request, options = nil)
@@ -990,12 +1043,15 @@ module Google
990
1043
  # the default parameter values, pass an empty Hash as a request object (see above).
991
1044
  #
992
1045
  # @param name [::String]
993
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to disable in the format
994
- # `projects/*/secrets/*/versions/*`.
1046
+ # Required. The resource name of the
1047
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to disable in
1048
+ # the format `projects/*/secrets/*/versions/*` or
1049
+ # `projects/*/locations/*/secrets/*/versions/*`.
995
1050
  # @param etag [::String]
996
- # Optional. Etag of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request succeeds if it matches
997
- # the etag of the currently stored secret version object. If the etag is
998
- # omitted, the request succeeds.
1051
+ # Optional. Etag of the
1052
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request
1053
+ # succeeds if it matches the etag of the currently stored secret version
1054
+ # object. If the etag is omitted, the request succeeds.
999
1055
  # @yield [result, operation] Access the result along with the TransportOperation object
1000
1056
  # @yieldparam result [::Google::Cloud::SecretManager::V1::SecretVersion]
1001
1057
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1030,12 +1086,13 @@ module Google
1030
1086
  # Customize the options with defaults
1031
1087
  call_metadata = @config.rpcs.disable_secret_version.metadata.to_h
1032
1088
 
1033
- # Set x-goog-api-client and x-goog-user-project headers
1089
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1034
1090
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1035
1091
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1036
1092
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1037
1093
  transports_version_send: [:rest]
1038
1094
 
1095
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1039
1096
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1040
1097
 
1041
1098
  options.apply_defaults timeout: @config.rpcs.disable_secret_version.timeout,
@@ -1057,7 +1114,8 @@ module Google
1057
1114
  ##
1058
1115
  # Enables a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
1059
1116
  #
1060
- # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
1117
+ # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the
1118
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
1061
1119
  # {::Google::Cloud::SecretManager::V1::SecretVersion::State::ENABLED ENABLED}.
1062
1120
  #
1063
1121
  # @overload enable_secret_version(request, options = nil)
@@ -1076,12 +1134,15 @@ module Google
1076
1134
  # the default parameter values, pass an empty Hash as a request object (see above).
1077
1135
  #
1078
1136
  # @param name [::String]
1079
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to enable in the format
1080
- # `projects/*/secrets/*/versions/*`.
1137
+ # Required. The resource name of the
1138
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to enable in
1139
+ # the format `projects/*/secrets/*/versions/*` or
1140
+ # `projects/*/locations/*/secrets/*/versions/*`.
1081
1141
  # @param etag [::String]
1082
- # Optional. Etag of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request succeeds if it matches
1083
- # the etag of the currently stored secret version object. If the etag is
1084
- # omitted, the request succeeds.
1142
+ # Optional. Etag of the
1143
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request
1144
+ # succeeds if it matches the etag of the currently stored secret version
1145
+ # object. If the etag is omitted, the request succeeds.
1085
1146
  # @yield [result, operation] Access the result along with the TransportOperation object
1086
1147
  # @yieldparam result [::Google::Cloud::SecretManager::V1::SecretVersion]
1087
1148
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1116,12 +1177,13 @@ module Google
1116
1177
  # Customize the options with defaults
1117
1178
  call_metadata = @config.rpcs.enable_secret_version.metadata.to_h
1118
1179
 
1119
- # Set x-goog-api-client and x-goog-user-project headers
1180
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1120
1181
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1121
1182
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1122
1183
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1123
1184
  transports_version_send: [:rest]
1124
1185
 
1186
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1125
1187
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1126
1188
 
1127
1189
  options.apply_defaults timeout: @config.rpcs.enable_secret_version.timeout,
@@ -1143,9 +1205,10 @@ module Google
1143
1205
  ##
1144
1206
  # Destroys a {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}.
1145
1207
  #
1146
- # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
1147
- # {::Google::Cloud::SecretManager::V1::SecretVersion::State::DESTROYED DESTROYED} and irrevocably destroys the
1148
- # secret data.
1208
+ # Sets the {::Google::Cloud::SecretManager::V1::SecretVersion#state state} of the
1209
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to
1210
+ # {::Google::Cloud::SecretManager::V1::SecretVersion::State::DESTROYED DESTROYED}
1211
+ # and irrevocably destroys the secret data.
1149
1212
  #
1150
1213
  # @overload destroy_secret_version(request, options = nil)
1151
1214
  # Pass arguments to `destroy_secret_version` via a request object, either of type
@@ -1163,12 +1226,15 @@ module Google
1163
1226
  # the default parameter values, pass an empty Hash as a request object (see above).
1164
1227
  #
1165
1228
  # @param name [::String]
1166
- # Required. The resource name of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to destroy in the format
1167
- # `projects/*/secrets/*/versions/*`.
1229
+ # Required. The resource name of the
1230
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion} to destroy in
1231
+ # the format `projects/*/secrets/*/versions/*` or
1232
+ # `projects/*/locations/*/secrets/*/versions/*`.
1168
1233
  # @param etag [::String]
1169
- # Optional. Etag of the {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request succeeds if it matches
1170
- # the etag of the currently stored secret version object. If the etag is
1171
- # omitted, the request succeeds.
1234
+ # Optional. Etag of the
1235
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersion}. The request
1236
+ # succeeds if it matches the etag of the currently stored secret version
1237
+ # object. If the etag is omitted, the request succeeds.
1172
1238
  # @yield [result, operation] Access the result along with the TransportOperation object
1173
1239
  # @yieldparam result [::Google::Cloud::SecretManager::V1::SecretVersion]
1174
1240
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1203,12 +1269,13 @@ module Google
1203
1269
  # Customize the options with defaults
1204
1270
  call_metadata = @config.rpcs.destroy_secret_version.metadata.to_h
1205
1271
 
1206
- # Set x-goog-api-client and x-goog-user-project headers
1272
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1207
1273
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1208
1274
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1209
1275
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1210
1276
  transports_version_send: [:rest]
1211
1277
 
1278
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1212
1279
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1213
1280
 
1214
1281
  options.apply_defaults timeout: @config.rpcs.destroy_secret_version.timeout,
@@ -1231,8 +1298,10 @@ module Google
1231
1298
  # Sets the access control policy on the specified secret. Replaces any
1232
1299
  # existing policy.
1233
1300
  #
1234
- # Permissions on {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions} are enforced according
1235
- # to the policy set on the associated {::Google::Cloud::SecretManager::V1::Secret Secret}.
1301
+ # Permissions on
1302
+ # {::Google::Cloud::SecretManager::V1::SecretVersion SecretVersions} are enforced
1303
+ # according to the policy set on the associated
1304
+ # {::Google::Cloud::SecretManager::V1::Secret Secret}.
1236
1305
  #
1237
1306
  # @overload set_iam_policy(request, options = nil)
1238
1307
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -1297,12 +1366,13 @@ module Google
1297
1366
  # Customize the options with defaults
1298
1367
  call_metadata = @config.rpcs.set_iam_policy.metadata.to_h
1299
1368
 
1300
- # Set x-goog-api-client and x-goog-user-project headers
1369
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1301
1370
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1302
1371
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1303
1372
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1304
1373
  transports_version_send: [:rest]
1305
1374
 
1375
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1306
1376
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1307
1377
 
1308
1378
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
@@ -1380,12 +1450,13 @@ module Google
1380
1450
  # Customize the options with defaults
1381
1451
  call_metadata = @config.rpcs.get_iam_policy.metadata.to_h
1382
1452
 
1383
- # Set x-goog-api-client and x-goog-user-project headers
1453
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1384
1454
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1385
1455
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1386
1456
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1387
1457
  transports_version_send: [:rest]
1388
1458
 
1459
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1389
1460
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1390
1461
 
1391
1462
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
@@ -1470,12 +1541,13 @@ module Google
1470
1541
  # Customize the options with defaults
1471
1542
  call_metadata = @config.rpcs.test_iam_permissions.metadata.to_h
1472
1543
 
1473
- # Set x-goog-api-client and x-goog-user-project headers
1544
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1474
1545
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1475
1546
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1476
1547
  gapic_version: ::Google::Cloud::SecretManager::V1::VERSION,
1477
1548
  transports_version_send: [:rest]
1478
1549
 
1550
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1479
1551
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1480
1552
 
1481
1553
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
@@ -1590,6 +1662,13 @@ module Google
1590
1662
  config_attr :quota_project, nil, ::String, nil
1591
1663
  config_attr :universe_domain, nil, ::String, nil
1592
1664
 
1665
+ # @private
1666
+ # Overrides for http bindings for the RPCs of this service
1667
+ # are only used when this service is used as mixin, and only
1668
+ # by the host service.
1669
+ # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1670
+ config_attr :bindings_override, {}, ::Hash, nil
1671
+
1593
1672
  # @private
1594
1673
  def initialize parent_config = nil
1595
1674
  @parent_config = parent_config unless parent_config.nil?