google-cloud-secret_manager-v1 0.20.0 → 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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?