google-cloud-backupdr-v1 0.2.1 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (27) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/backupdr/v1/backupdr/client.rb +2829 -157
  3. data/lib/google/cloud/backupdr/v1/backupdr/operations.rb +3 -10
  4. data/lib/google/cloud/backupdr/v1/backupdr/paths.rb +101 -0
  5. data/lib/google/cloud/backupdr/v1/backupdr/rest/client.rb +2656 -151
  6. data/lib/google/cloud/backupdr/v1/backupdr/rest/operations.rb +3 -10
  7. data/lib/google/cloud/backupdr/v1/backupdr/rest/service_stub.rb +1382 -17
  8. data/lib/google/cloud/backupdr/v1/backupdr_pb.rb +5 -1
  9. data/lib/google/cloud/backupdr/v1/backupdr_services_pb.rb +48 -0
  10. data/lib/google/cloud/backupdr/v1/backupplan_pb.rb +62 -0
  11. data/lib/google/cloud/backupdr/v1/backupplanassociation_pb.rb +59 -0
  12. data/lib/google/cloud/backupdr/v1/backupvault_ba_pb.rb +46 -0
  13. data/lib/google/cloud/backupdr/v1/backupvault_gce_pb.rb +87 -0
  14. data/lib/google/cloud/backupdr/v1/backupvault_pb.rb +99 -0
  15. data/lib/google/cloud/backupdr/v1/version.rb +1 -1
  16. data/proto_docs/google/api/client.rb +20 -0
  17. data/proto_docs/google/api/field_info.rb +88 -0
  18. data/proto_docs/google/cloud/backupdr/v1/backupdr.rb +11 -10
  19. data/proto_docs/google/cloud/backupdr/v1/backupplan.rb +414 -0
  20. data/proto_docs/google/cloud/backupdr/v1/backupplanassociation.rb +272 -0
  21. data/proto_docs/google/cloud/backupdr/v1/backupvault.rb +1103 -0
  22. data/proto_docs/google/cloud/backupdr/v1/backupvault_ba.rb +47 -0
  23. data/proto_docs/google/cloud/backupdr/v1/backupvault_gce.rb +993 -0
  24. data/proto_docs/google/longrunning/operations.rb +19 -14
  25. data/proto_docs/google/type/dayofweek.rb +49 -0
  26. data/proto_docs/google/type/month.rb +64 -0
  27. metadata +16 -3
@@ -88,6 +88,59 @@ module Google
88
88
 
89
89
  default_config.rpcs.delete_management_server.timeout = 60.0
90
90
 
91
+ default_config.rpcs.create_backup_vault.timeout = 60.0
92
+ default_config.rpcs.create_backup_vault.retry_policy = {
93
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
94
+ }
95
+
96
+ default_config.rpcs.list_backup_vaults.timeout = 60.0
97
+ default_config.rpcs.list_backup_vaults.retry_policy = {
98
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
99
+ }
100
+
101
+ default_config.rpcs.fetch_usable_backup_vaults.timeout = 60.0
102
+ default_config.rpcs.fetch_usable_backup_vaults.retry_policy = {
103
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
104
+ }
105
+
106
+ default_config.rpcs.get_backup_vault.timeout = 60.0
107
+ default_config.rpcs.get_backup_vault.retry_policy = {
108
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
109
+ }
110
+
111
+ default_config.rpcs.update_backup_vault.timeout = 60.0
112
+
113
+ default_config.rpcs.delete_backup_vault.timeout = 60.0
114
+ default_config.rpcs.delete_backup_vault.retry_policy = {
115
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
116
+ }
117
+
118
+ default_config.rpcs.list_data_sources.timeout = 60.0
119
+ default_config.rpcs.list_data_sources.retry_policy = {
120
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
121
+ }
122
+
123
+ default_config.rpcs.get_data_source.timeout = 60.0
124
+ default_config.rpcs.get_data_source.retry_policy = {
125
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
126
+ }
127
+
128
+ default_config.rpcs.update_data_source.timeout = 60.0
129
+
130
+ default_config.rpcs.list_backups.timeout = 60.0
131
+ default_config.rpcs.list_backups.retry_policy = {
132
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
133
+ }
134
+
135
+ default_config.rpcs.get_backup.timeout = 60.0
136
+ default_config.rpcs.get_backup.retry_policy = {
137
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
138
+ }
139
+
140
+ default_config.rpcs.update_backup.timeout = 60.0
141
+
142
+ default_config.rpcs.restore_backup.timeout = 60.0
143
+
91
144
  default_config
92
145
  end
93
146
  yield @configure if block_given?
@@ -236,10 +289,11 @@ module Google
236
289
  #
237
290
  # @param parent [::String]
238
291
  # Required. The project and location for which to retrieve management servers
239
- # information, in the format `projects/{project_id}/locations/{location}`. In
240
- # Cloud BackupDR, locations map to GCP regions, for example **us-central1**.
241
- # To retrieve management servers for all locations, use "-" for the
242
- # `{location}` value.
292
+ # information, in the format 'projects/\\{project_id}/locations/\\{location}'. In
293
+ # Cloud BackupDR, locations map to Google Cloud regions, for example
294
+ # **us-central1**. To retrieve management servers for all locations, use "-"
295
+ # for the
296
+ # '\\{location}' value.
243
297
  # @param page_size [::Integer]
244
298
  # Optional. Requested page size. Server may return fewer items than
245
299
  # requested. If unspecified, server will pick an appropriate default.
@@ -332,7 +386,7 @@ module Google
332
386
  #
333
387
  # @param name [::String]
334
388
  # Required. Name of the management server resource name, in the format
335
- # `projects/{project_id}/locations/{location}/managementServers/{resource_name}`
389
+ # 'projects/\\{project_id}/locations/\\{location}/managementServers/\\{resource_name}'
336
390
  # @yield [result, operation] Access the result along with the TransportOperation object
337
391
  # @yieldparam result [::Google::Cloud::BackupDR::V1::ManagementServer]
338
392
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -412,8 +466,8 @@ module Google
412
466
  #
413
467
  # @param parent [::String]
414
468
  # Required. The management server project and location in the format
415
- # `projects/{project_id}/locations/{location}`. In Cloud Backup and DR
416
- # locations map to GCP regions, for example **us-central1**.
469
+ # 'projects/\\{project_id}/locations/\\{location}'. In Cloud Backup and DR
470
+ # locations map to Google Cloud regions, for example **us-central1**.
417
471
  # @param management_server_id [::String]
418
472
  # Required. The name of the management server to create. The name must be
419
473
  # unique for the specified project and location.
@@ -603,165 +657,2570 @@ module Google
603
657
  end
604
658
 
605
659
  ##
606
- # Configuration class for the BackupDR REST API.
660
+ # Creates a new BackupVault in a given project and location.
607
661
  #
608
- # This class represents the configuration for BackupDR REST,
609
- # providing control over timeouts, retry behavior, logging, transport
610
- # parameters, and other low-level controls. Certain parameters can also be
611
- # applied individually to specific RPCs. See
612
- # {::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client::Configuration::Rpcs}
613
- # for a list of RPCs that can be configured independently.
662
+ # @overload create_backup_vault(request, options = nil)
663
+ # Pass arguments to `create_backup_vault` via a request object, either of type
664
+ # {::Google::Cloud::BackupDR::V1::CreateBackupVaultRequest} or an equivalent Hash.
614
665
  #
615
- # Configuration can be applied globally to all clients, or to a single client
616
- # on construction.
666
+ # @param request [::Google::Cloud::BackupDR::V1::CreateBackupVaultRequest, ::Hash]
667
+ # A request object representing the call parameters. Required. To specify no
668
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
669
+ # @param options [::Gapic::CallOptions, ::Hash]
670
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
617
671
  #
618
- # @example
672
+ # @overload create_backup_vault(parent: nil, backup_vault_id: nil, backup_vault: nil, request_id: nil, validate_only: nil)
673
+ # Pass arguments to `create_backup_vault` via keyword arguments. Note that at
674
+ # least one keyword argument is required. To specify no parameters, or to keep all
675
+ # the default parameter values, pass an empty Hash as a request object (see above).
619
676
  #
620
- # # Modify the global config, setting the timeout for
621
- # # list_management_servers to 20 seconds,
622
- # # and all remaining timeouts to 10 seconds.
623
- # ::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.configure do |config|
624
- # config.timeout = 10.0
625
- # config.rpcs.list_management_servers.timeout = 20.0
626
- # end
677
+ # @param parent [::String]
678
+ # Required. Value for parent.
679
+ # @param backup_vault_id [::String]
680
+ # Required. ID of the requesting object
681
+ # If auto-generating ID server-side, remove this field and
682
+ # backup_vault_id from the method_signature of Create RPC
683
+ # @param backup_vault [::Google::Cloud::BackupDR::V1::BackupVault, ::Hash]
684
+ # Required. The resource being created
685
+ # @param request_id [::String]
686
+ # Optional. An optional request ID to identify requests. Specify a unique
687
+ # request ID so that if you must retry your request, the server will know to
688
+ # ignore the request if it has already been completed. The server will
689
+ # guarantee that for at least 60 minutes since the first request.
627
690
  #
628
- # # Apply the above configuration only to a new client.
629
- # client = ::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new do |config|
630
- # config.timeout = 10.0
631
- # config.rpcs.list_management_servers.timeout = 20.0
632
- # end
691
+ # For example, consider a situation where you make an initial request and
692
+ # the request times out. If you make the request again with the same request
693
+ # ID, the server can check if original operation with the same request ID
694
+ # was received, and if so, will ignore the second request. This prevents
695
+ # clients from accidentally creating duplicate commitments.
633
696
  #
634
- # @!attribute [rw] endpoint
635
- # A custom service endpoint, as a hostname or hostname:port. The default is
636
- # nil, indicating to use the default endpoint in the current universe domain.
637
- # @return [::String,nil]
638
- # @!attribute [rw] credentials
639
- # Credentials to send with calls. You may provide any of the following types:
640
- # * (`String`) The path to a service account key file in JSON format
641
- # * (`Hash`) A service account key as a Hash
642
- # * (`Google::Auth::Credentials`) A googleauth credentials object
643
- # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
644
- # * (`Signet::OAuth2::Client`) A signet oauth2 client object
645
- # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
646
- # * (`nil`) indicating no credentials
647
- # @return [::Object]
648
- # @!attribute [rw] scope
649
- # The OAuth scopes
650
- # @return [::Array<::String>]
651
- # @!attribute [rw] lib_name
652
- # The library name as recorded in instrumentation and logging
653
- # @return [::String]
654
- # @!attribute [rw] lib_version
655
- # The library version as recorded in instrumentation and logging
656
- # @return [::String]
657
- # @!attribute [rw] timeout
658
- # The call timeout in seconds.
659
- # @return [::Numeric]
660
- # @!attribute [rw] metadata
661
- # Additional headers to be sent with the call.
662
- # @return [::Hash{::Symbol=>::String}]
663
- # @!attribute [rw] retry_policy
664
- # The retry policy. The value is a hash with the following keys:
665
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
666
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
667
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
668
- # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
669
- # trigger a retry.
670
- # @return [::Hash]
671
- # @!attribute [rw] quota_project
672
- # A separate project against which to charge quota.
673
- # @return [::String]
674
- # @!attribute [rw] universe_domain
675
- # The universe domain within which to make requests. This determines the
676
- # default endpoint URL. The default value of nil uses the environment
677
- # universe (usually the default "googleapis.com" universe).
678
- # @return [::String,nil]
697
+ # The request ID must be a valid UUID with the exception that zero UUID is
698
+ # not supported (00000000-0000-0000-0000-000000000000).
699
+ # @param validate_only [::Boolean]
700
+ # Optional. Only validate the request, but do not perform mutations.
701
+ # The default is 'false'.
702
+ # @yield [result, operation] Access the result along with the TransportOperation object
703
+ # @yieldparam result [::Gapic::Operation]
704
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
679
705
  #
680
- class Configuration
681
- extend ::Gapic::Config
706
+ # @return [::Gapic::Operation]
707
+ #
708
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
709
+ #
710
+ # @example Basic example
711
+ # require "google/cloud/backupdr/v1"
712
+ #
713
+ # # Create a client object. The client can be reused for multiple calls.
714
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
715
+ #
716
+ # # Create a request. To set request fields, pass in keyword arguments.
717
+ # request = Google::Cloud::BackupDR::V1::CreateBackupVaultRequest.new
718
+ #
719
+ # # Call the create_backup_vault method.
720
+ # result = client.create_backup_vault request
721
+ #
722
+ # # The returned object is of type Gapic::Operation. You can use it to
723
+ # # check the status of an operation, cancel it, or wait for results.
724
+ # # Here is how to wait for a response.
725
+ # result.wait_until_done! timeout: 60
726
+ # if result.response?
727
+ # p result.response
728
+ # else
729
+ # puts "No response received."
730
+ # end
731
+ #
732
+ def create_backup_vault request, options = nil
733
+ raise ::ArgumentError, "request must be provided" if request.nil?
682
734
 
683
- # @private
684
- # The endpoint specific to the default "googleapis.com" universe. Deprecated.
685
- DEFAULT_ENDPOINT = "backupdr.googleapis.com"
735
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::CreateBackupVaultRequest
686
736
 
687
- config_attr :endpoint, nil, ::String, nil
688
- config_attr :credentials, nil do |value|
689
- allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
690
- allowed.any? { |klass| klass === value }
691
- end
692
- config_attr :scope, nil, ::String, ::Array, nil
693
- config_attr :lib_name, nil, ::String, nil
694
- config_attr :lib_version, nil, ::String, nil
695
- config_attr :timeout, nil, ::Numeric, nil
696
- config_attr :metadata, nil, ::Hash, nil
697
- config_attr :retry_policy, nil, ::Hash, ::Proc, nil
698
- config_attr :quota_project, nil, ::String, nil
699
- config_attr :universe_domain, nil, ::String, nil
737
+ # Converts hash and nil to an options object
738
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
700
739
 
701
- # @private
702
- # Overrides for http bindings for the RPCs of this service
703
- # are only used when this service is used as mixin, and only
704
- # by the host service.
705
- # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
706
- config_attr :bindings_override, {}, ::Hash, nil
740
+ # Customize the options with defaults
741
+ call_metadata = @config.rpcs.create_backup_vault.metadata.to_h
707
742
 
708
- # @private
709
- def initialize parent_config = nil
710
- @parent_config = parent_config unless parent_config.nil?
743
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
744
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
745
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
746
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
747
+ transports_version_send: [:rest]
711
748
 
712
- yield self if block_given?
713
- end
749
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
750
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
714
751
 
715
- ##
716
- # Configurations for individual RPCs
717
- # @return [Rpcs]
718
- #
719
- def rpcs
720
- @rpcs ||= begin
721
- parent_rpcs = nil
722
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
723
- Rpcs.new parent_rpcs
724
- end
752
+ options.apply_defaults timeout: @config.rpcs.create_backup_vault.timeout,
753
+ metadata: call_metadata,
754
+ retry_policy: @config.rpcs.create_backup_vault.retry_policy
755
+
756
+ options.apply_defaults timeout: @config.timeout,
757
+ metadata: @config.metadata,
758
+ retry_policy: @config.retry_policy
759
+
760
+ @backup_dr_stub.create_backup_vault request, options do |result, operation|
761
+ result = ::Gapic::Operation.new result, @operations_client, options: options
762
+ yield result, operation if block_given?
763
+ return result
725
764
  end
765
+ rescue ::Gapic::Rest::Error => e
766
+ raise ::Google::Cloud::Error.from_error(e)
767
+ end
726
768
 
727
- ##
728
- # Configuration RPC class for the BackupDR API.
729
- #
730
- # Includes fields providing the configuration for each RPC in this service.
731
- # Each configuration object is of type `Gapic::Config::Method` and includes
732
- # the following configuration fields:
733
- #
734
- # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
735
- # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
736
- # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
737
- # include the following keys:
738
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
739
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
740
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
741
- # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
742
- # trigger a retry.
743
- #
744
- class Rpcs
745
- ##
746
- # RPC-specific configuration for `list_management_servers`
747
- # @return [::Gapic::Config::Method]
748
- #
749
- attr_reader :list_management_servers
750
- ##
751
- # RPC-specific configuration for `get_management_server`
752
- # @return [::Gapic::Config::Method]
753
- #
754
- attr_reader :get_management_server
755
- ##
756
- # RPC-specific configuration for `create_management_server`
757
- # @return [::Gapic::Config::Method]
758
- #
759
- attr_reader :create_management_server
760
- ##
761
- # RPC-specific configuration for `delete_management_server`
762
- # @return [::Gapic::Config::Method]
763
- #
764
- attr_reader :delete_management_server
769
+ ##
770
+ # Lists BackupVaults in a given project and location.
771
+ #
772
+ # @overload list_backup_vaults(request, options = nil)
773
+ # Pass arguments to `list_backup_vaults` via a request object, either of type
774
+ # {::Google::Cloud::BackupDR::V1::ListBackupVaultsRequest} or an equivalent Hash.
775
+ #
776
+ # @param request [::Google::Cloud::BackupDR::V1::ListBackupVaultsRequest, ::Hash]
777
+ # A request object representing the call parameters. Required. To specify no
778
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
779
+ # @param options [::Gapic::CallOptions, ::Hash]
780
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
781
+ #
782
+ # @overload list_backup_vaults(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, view: nil)
783
+ # Pass arguments to `list_backup_vaults` via keyword arguments. Note that at
784
+ # least one keyword argument is required. To specify no parameters, or to keep all
785
+ # the default parameter values, pass an empty Hash as a request object (see above).
786
+ #
787
+ # @param parent [::String]
788
+ # Required. The project and location for which to retrieve backupvault stores
789
+ # information, in the format 'projects/\\{project_id}/locations/\\{location}'. In
790
+ # Cloud Backup and DR, locations map to Google Cloud regions, for example
791
+ # **us-central1**.
792
+ # To retrieve backupvault stores for all locations, use "-" for the
793
+ # '\\{location}' value.
794
+ # @param page_size [::Integer]
795
+ # Optional. Requested page size. Server may return fewer items than
796
+ # requested. If unspecified, server will pick an appropriate default.
797
+ # @param page_token [::String]
798
+ # Optional. A token identifying a page of results the server should return.
799
+ # @param filter [::String]
800
+ # Optional. Filtering results.
801
+ # @param order_by [::String]
802
+ # Optional. Hint for how to order the results.
803
+ # @param view [::Google::Cloud::BackupDR::V1::BackupVaultView]
804
+ # Optional. Reserved for future use to provide a BASIC & FULL view of Backup
805
+ # Vault.
806
+ # @yield [result, operation] Access the result along with the TransportOperation object
807
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::ListBackupVaultsResponse]
808
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
809
+ #
810
+ # @return [::Google::Cloud::BackupDR::V1::ListBackupVaultsResponse]
811
+ #
812
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
813
+ #
814
+ # @example Basic example
815
+ # require "google/cloud/backupdr/v1"
816
+ #
817
+ # # Create a client object. The client can be reused for multiple calls.
818
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
819
+ #
820
+ # # Create a request. To set request fields, pass in keyword arguments.
821
+ # request = Google::Cloud::BackupDR::V1::ListBackupVaultsRequest.new
822
+ #
823
+ # # Call the list_backup_vaults method.
824
+ # result = client.list_backup_vaults request
825
+ #
826
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
827
+ # # over elements, and API calls will be issued to fetch pages as needed.
828
+ # result.each do |item|
829
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::BackupVault.
830
+ # p item
831
+ # end
832
+ #
833
+ def list_backup_vaults request, options = nil
834
+ raise ::ArgumentError, "request must be provided" if request.nil?
835
+
836
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::ListBackupVaultsRequest
837
+
838
+ # Converts hash and nil to an options object
839
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
840
+
841
+ # Customize the options with defaults
842
+ call_metadata = @config.rpcs.list_backup_vaults.metadata.to_h
843
+
844
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
845
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
846
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
847
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
848
+ transports_version_send: [:rest]
849
+
850
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
851
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
852
+
853
+ options.apply_defaults timeout: @config.rpcs.list_backup_vaults.timeout,
854
+ metadata: call_metadata,
855
+ retry_policy: @config.rpcs.list_backup_vaults.retry_policy
856
+
857
+ options.apply_defaults timeout: @config.timeout,
858
+ metadata: @config.metadata,
859
+ retry_policy: @config.retry_policy
860
+
861
+ @backup_dr_stub.list_backup_vaults request, options do |result, operation|
862
+ yield result, operation if block_given?
863
+ return result
864
+ end
865
+ rescue ::Gapic::Rest::Error => e
866
+ raise ::Google::Cloud::Error.from_error(e)
867
+ end
868
+
869
+ ##
870
+ # FetchUsableBackupVaults lists usable BackupVaults in a given project and
871
+ # location. Usable BackupVault are the ones that user has
872
+ # backupdr.backupVaults.get permission.
873
+ #
874
+ # @overload fetch_usable_backup_vaults(request, options = nil)
875
+ # Pass arguments to `fetch_usable_backup_vaults` via a request object, either of type
876
+ # {::Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsRequest} or an equivalent Hash.
877
+ #
878
+ # @param request [::Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsRequest, ::Hash]
879
+ # A request object representing the call parameters. Required. To specify no
880
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
881
+ # @param options [::Gapic::CallOptions, ::Hash]
882
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
883
+ #
884
+ # @overload fetch_usable_backup_vaults(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
885
+ # Pass arguments to `fetch_usable_backup_vaults` via keyword arguments. Note that at
886
+ # least one keyword argument is required. To specify no parameters, or to keep all
887
+ # the default parameter values, pass an empty Hash as a request object (see above).
888
+ #
889
+ # @param parent [::String]
890
+ # Required. The project and location for which to retrieve backupvault stores
891
+ # information, in the format 'projects/\\{project_id}/locations/\\{location}'. In
892
+ # Cloud Backup and DR, locations map to Google Cloud regions, for example
893
+ # **us-central1**.
894
+ # To retrieve backupvault stores for all locations, use "-" for the
895
+ # '\\{location}' value.
896
+ # @param page_size [::Integer]
897
+ # Optional. Requested page size. Server may return fewer items than
898
+ # requested. If unspecified, server will pick an appropriate default.
899
+ # @param page_token [::String]
900
+ # Optional. A token identifying a page of results the server should return.
901
+ # @param filter [::String]
902
+ # Optional. Filtering results.
903
+ # @param order_by [::String]
904
+ # Optional. Hint for how to order the results.
905
+ # @yield [result, operation] Access the result along with the TransportOperation object
906
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsResponse]
907
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
908
+ #
909
+ # @return [::Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsResponse]
910
+ #
911
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
912
+ #
913
+ # @example Basic example
914
+ # require "google/cloud/backupdr/v1"
915
+ #
916
+ # # Create a client object. The client can be reused for multiple calls.
917
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
918
+ #
919
+ # # Create a request. To set request fields, pass in keyword arguments.
920
+ # request = Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsRequest.new
921
+ #
922
+ # # Call the fetch_usable_backup_vaults method.
923
+ # result = client.fetch_usable_backup_vaults request
924
+ #
925
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
926
+ # # over elements, and API calls will be issued to fetch pages as needed.
927
+ # result.each do |item|
928
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::BackupVault.
929
+ # p item
930
+ # end
931
+ #
932
+ def fetch_usable_backup_vaults request, options = nil
933
+ raise ::ArgumentError, "request must be provided" if request.nil?
934
+
935
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::FetchUsableBackupVaultsRequest
936
+
937
+ # Converts hash and nil to an options object
938
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
939
+
940
+ # Customize the options with defaults
941
+ call_metadata = @config.rpcs.fetch_usable_backup_vaults.metadata.to_h
942
+
943
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
944
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
945
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
946
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
947
+ transports_version_send: [:rest]
948
+
949
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
950
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
951
+
952
+ options.apply_defaults timeout: @config.rpcs.fetch_usable_backup_vaults.timeout,
953
+ metadata: call_metadata,
954
+ retry_policy: @config.rpcs.fetch_usable_backup_vaults.retry_policy
955
+
956
+ options.apply_defaults timeout: @config.timeout,
957
+ metadata: @config.metadata,
958
+ retry_policy: @config.retry_policy
959
+
960
+ @backup_dr_stub.fetch_usable_backup_vaults request, options do |result, operation|
961
+ yield result, operation if block_given?
962
+ return result
963
+ end
964
+ rescue ::Gapic::Rest::Error => e
965
+ raise ::Google::Cloud::Error.from_error(e)
966
+ end
967
+
968
+ ##
969
+ # Gets details of a BackupVault.
970
+ #
971
+ # @overload get_backup_vault(request, options = nil)
972
+ # Pass arguments to `get_backup_vault` via a request object, either of type
973
+ # {::Google::Cloud::BackupDR::V1::GetBackupVaultRequest} or an equivalent Hash.
974
+ #
975
+ # @param request [::Google::Cloud::BackupDR::V1::GetBackupVaultRequest, ::Hash]
976
+ # A request object representing the call parameters. Required. To specify no
977
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
978
+ # @param options [::Gapic::CallOptions, ::Hash]
979
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
980
+ #
981
+ # @overload get_backup_vault(name: nil, view: nil)
982
+ # Pass arguments to `get_backup_vault` via keyword arguments. Note that at
983
+ # least one keyword argument is required. To specify no parameters, or to keep all
984
+ # the default parameter values, pass an empty Hash as a request object (see above).
985
+ #
986
+ # @param name [::String]
987
+ # Required. Name of the backupvault store resource name, in the format
988
+ # 'projects/\\{project_id}/locations/\\{location}/backupVaults/\\{resource_name}'
989
+ # @param view [::Google::Cloud::BackupDR::V1::BackupVaultView]
990
+ # Optional. Reserved for future use to provide a BASIC & FULL view of Backup
991
+ # Vault
992
+ # @yield [result, operation] Access the result along with the TransportOperation object
993
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::BackupVault]
994
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
995
+ #
996
+ # @return [::Google::Cloud::BackupDR::V1::BackupVault]
997
+ #
998
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
999
+ #
1000
+ # @example Basic example
1001
+ # require "google/cloud/backupdr/v1"
1002
+ #
1003
+ # # Create a client object. The client can be reused for multiple calls.
1004
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1005
+ #
1006
+ # # Create a request. To set request fields, pass in keyword arguments.
1007
+ # request = Google::Cloud::BackupDR::V1::GetBackupVaultRequest.new
1008
+ #
1009
+ # # Call the get_backup_vault method.
1010
+ # result = client.get_backup_vault request
1011
+ #
1012
+ # # The returned object is of type Google::Cloud::BackupDR::V1::BackupVault.
1013
+ # p result
1014
+ #
1015
+ def get_backup_vault request, options = nil
1016
+ raise ::ArgumentError, "request must be provided" if request.nil?
1017
+
1018
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::GetBackupVaultRequest
1019
+
1020
+ # Converts hash and nil to an options object
1021
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1022
+
1023
+ # Customize the options with defaults
1024
+ call_metadata = @config.rpcs.get_backup_vault.metadata.to_h
1025
+
1026
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1027
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1028
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1029
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1030
+ transports_version_send: [:rest]
1031
+
1032
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1033
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1034
+
1035
+ options.apply_defaults timeout: @config.rpcs.get_backup_vault.timeout,
1036
+ metadata: call_metadata,
1037
+ retry_policy: @config.rpcs.get_backup_vault.retry_policy
1038
+
1039
+ options.apply_defaults timeout: @config.timeout,
1040
+ metadata: @config.metadata,
1041
+ retry_policy: @config.retry_policy
1042
+
1043
+ @backup_dr_stub.get_backup_vault request, options do |result, operation|
1044
+ yield result, operation if block_given?
1045
+ return result
1046
+ end
1047
+ rescue ::Gapic::Rest::Error => e
1048
+ raise ::Google::Cloud::Error.from_error(e)
1049
+ end
1050
+
1051
+ ##
1052
+ # Updates the settings of a BackupVault.
1053
+ #
1054
+ # @overload update_backup_vault(request, options = nil)
1055
+ # Pass arguments to `update_backup_vault` via a request object, either of type
1056
+ # {::Google::Cloud::BackupDR::V1::UpdateBackupVaultRequest} or an equivalent Hash.
1057
+ #
1058
+ # @param request [::Google::Cloud::BackupDR::V1::UpdateBackupVaultRequest, ::Hash]
1059
+ # A request object representing the call parameters. Required. To specify no
1060
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1061
+ # @param options [::Gapic::CallOptions, ::Hash]
1062
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1063
+ #
1064
+ # @overload update_backup_vault(update_mask: nil, backup_vault: nil, request_id: nil, validate_only: nil, force: nil)
1065
+ # Pass arguments to `update_backup_vault` via keyword arguments. Note that at
1066
+ # least one keyword argument is required. To specify no parameters, or to keep all
1067
+ # the default parameter values, pass an empty Hash as a request object (see above).
1068
+ #
1069
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1070
+ # Required. Field mask is used to specify the fields to be overwritten in the
1071
+ # BackupVault resource by the update.
1072
+ # The fields specified in the update_mask are relative to the resource, not
1073
+ # the full request. A field will be overwritten if it is in the mask. If the
1074
+ # user does not provide a mask then the request will fail.
1075
+ # @param backup_vault [::Google::Cloud::BackupDR::V1::BackupVault, ::Hash]
1076
+ # Required. The resource being updated
1077
+ # @param request_id [::String]
1078
+ # Optional. An optional request ID to identify requests. Specify a unique
1079
+ # request ID so that if you must retry your request, the server will know to
1080
+ # ignore the request if it has already been completed. The server will
1081
+ # guarantee that for at least 60 minutes since the first request.
1082
+ #
1083
+ # For example, consider a situation where you make an initial request and
1084
+ # the request times out. If you make the request again with the same request
1085
+ # ID, the server can check if original operation with the same request ID
1086
+ # was received, and if so, will ignore the second request. This prevents
1087
+ # clients from accidentally creating duplicate commitments.
1088
+ #
1089
+ # The request ID must be a valid UUID with the exception that zero UUID is
1090
+ # not supported (00000000-0000-0000-0000-000000000000).
1091
+ # @param validate_only [::Boolean]
1092
+ # Optional. Only validate the request, but do not perform mutations.
1093
+ # The default is 'false'.
1094
+ # @param force [::Boolean]
1095
+ # Optional. If set to true, will not check plan duration against backup vault
1096
+ # enforcement duration.
1097
+ # @yield [result, operation] Access the result along with the TransportOperation object
1098
+ # @yieldparam result [::Gapic::Operation]
1099
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1100
+ #
1101
+ # @return [::Gapic::Operation]
1102
+ #
1103
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1104
+ #
1105
+ # @example Basic example
1106
+ # require "google/cloud/backupdr/v1"
1107
+ #
1108
+ # # Create a client object. The client can be reused for multiple calls.
1109
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1110
+ #
1111
+ # # Create a request. To set request fields, pass in keyword arguments.
1112
+ # request = Google::Cloud::BackupDR::V1::UpdateBackupVaultRequest.new
1113
+ #
1114
+ # # Call the update_backup_vault method.
1115
+ # result = client.update_backup_vault request
1116
+ #
1117
+ # # The returned object is of type Gapic::Operation. You can use it to
1118
+ # # check the status of an operation, cancel it, or wait for results.
1119
+ # # Here is how to wait for a response.
1120
+ # result.wait_until_done! timeout: 60
1121
+ # if result.response?
1122
+ # p result.response
1123
+ # else
1124
+ # puts "No response received."
1125
+ # end
1126
+ #
1127
+ def update_backup_vault request, options = nil
1128
+ raise ::ArgumentError, "request must be provided" if request.nil?
1129
+
1130
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::UpdateBackupVaultRequest
1131
+
1132
+ # Converts hash and nil to an options object
1133
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1134
+
1135
+ # Customize the options with defaults
1136
+ call_metadata = @config.rpcs.update_backup_vault.metadata.to_h
1137
+
1138
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1139
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1140
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1141
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1142
+ transports_version_send: [:rest]
1143
+
1144
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1145
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1146
+
1147
+ options.apply_defaults timeout: @config.rpcs.update_backup_vault.timeout,
1148
+ metadata: call_metadata,
1149
+ retry_policy: @config.rpcs.update_backup_vault.retry_policy
1150
+
1151
+ options.apply_defaults timeout: @config.timeout,
1152
+ metadata: @config.metadata,
1153
+ retry_policy: @config.retry_policy
1154
+
1155
+ @backup_dr_stub.update_backup_vault request, options do |result, operation|
1156
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1157
+ yield result, operation if block_given?
1158
+ return result
1159
+ end
1160
+ rescue ::Gapic::Rest::Error => e
1161
+ raise ::Google::Cloud::Error.from_error(e)
1162
+ end
1163
+
1164
+ ##
1165
+ # Deletes a BackupVault.
1166
+ #
1167
+ # @overload delete_backup_vault(request, options = nil)
1168
+ # Pass arguments to `delete_backup_vault` via a request object, either of type
1169
+ # {::Google::Cloud::BackupDR::V1::DeleteBackupVaultRequest} or an equivalent Hash.
1170
+ #
1171
+ # @param request [::Google::Cloud::BackupDR::V1::DeleteBackupVaultRequest, ::Hash]
1172
+ # A request object representing the call parameters. Required. To specify no
1173
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1174
+ # @param options [::Gapic::CallOptions, ::Hash]
1175
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1176
+ #
1177
+ # @overload delete_backup_vault(name: nil, request_id: nil, force: nil, etag: nil, validate_only: nil, allow_missing: nil)
1178
+ # Pass arguments to `delete_backup_vault` via keyword arguments. Note that at
1179
+ # least one keyword argument is required. To specify no parameters, or to keep all
1180
+ # the default parameter values, pass an empty Hash as a request object (see above).
1181
+ #
1182
+ # @param name [::String]
1183
+ # Required. Name of the resource.
1184
+ # @param request_id [::String]
1185
+ # Optional. An optional request ID to identify requests. Specify a unique
1186
+ # request ID so that if you must retry your request, the server will know to
1187
+ # ignore the request if it has already been completed. The server will
1188
+ # guarantee that for at least 60 minutes after the first request.
1189
+ #
1190
+ # For example, consider a situation where you make an initial request and
1191
+ # the request times out. If you make the request again with the same request
1192
+ # ID, the server can check if original operation with the same request ID
1193
+ # was received, and if so, will ignore the second request. This prevents
1194
+ # clients from accidentally creating duplicate commitments.
1195
+ #
1196
+ # The request ID must be a valid UUID with the exception that zero UUID is
1197
+ # not supported (00000000-0000-0000-0000-000000000000).
1198
+ # @param force [::Boolean]
1199
+ # Optional. If set to true, any data source from this backup vault will also
1200
+ # be deleted.
1201
+ # @param etag [::String]
1202
+ # The current etag of the backup vault.
1203
+ # If an etag is provided and does not match the current etag of the
1204
+ # connection, deletion will be blocked.
1205
+ # @param validate_only [::Boolean]
1206
+ # Optional. Only validate the request, but do not perform mutations.
1207
+ # The default is 'false'.
1208
+ # @param allow_missing [::Boolean]
1209
+ # Optional. If true and the BackupVault is not found, the request will
1210
+ # succeed but no action will be taken.
1211
+ # @yield [result, operation] Access the result along with the TransportOperation object
1212
+ # @yieldparam result [::Gapic::Operation]
1213
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1214
+ #
1215
+ # @return [::Gapic::Operation]
1216
+ #
1217
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1218
+ #
1219
+ # @example Basic example
1220
+ # require "google/cloud/backupdr/v1"
1221
+ #
1222
+ # # Create a client object. The client can be reused for multiple calls.
1223
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1224
+ #
1225
+ # # Create a request. To set request fields, pass in keyword arguments.
1226
+ # request = Google::Cloud::BackupDR::V1::DeleteBackupVaultRequest.new
1227
+ #
1228
+ # # Call the delete_backup_vault method.
1229
+ # result = client.delete_backup_vault request
1230
+ #
1231
+ # # The returned object is of type Gapic::Operation. You can use it to
1232
+ # # check the status of an operation, cancel it, or wait for results.
1233
+ # # Here is how to wait for a response.
1234
+ # result.wait_until_done! timeout: 60
1235
+ # if result.response?
1236
+ # p result.response
1237
+ # else
1238
+ # puts "No response received."
1239
+ # end
1240
+ #
1241
+ def delete_backup_vault request, options = nil
1242
+ raise ::ArgumentError, "request must be provided" if request.nil?
1243
+
1244
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::DeleteBackupVaultRequest
1245
+
1246
+ # Converts hash and nil to an options object
1247
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1248
+
1249
+ # Customize the options with defaults
1250
+ call_metadata = @config.rpcs.delete_backup_vault.metadata.to_h
1251
+
1252
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1253
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1254
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1255
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1256
+ transports_version_send: [:rest]
1257
+
1258
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1259
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1260
+
1261
+ options.apply_defaults timeout: @config.rpcs.delete_backup_vault.timeout,
1262
+ metadata: call_metadata,
1263
+ retry_policy: @config.rpcs.delete_backup_vault.retry_policy
1264
+
1265
+ options.apply_defaults timeout: @config.timeout,
1266
+ metadata: @config.metadata,
1267
+ retry_policy: @config.retry_policy
1268
+
1269
+ @backup_dr_stub.delete_backup_vault request, options do |result, operation|
1270
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1271
+ yield result, operation if block_given?
1272
+ return result
1273
+ end
1274
+ rescue ::Gapic::Rest::Error => e
1275
+ raise ::Google::Cloud::Error.from_error(e)
1276
+ end
1277
+
1278
+ ##
1279
+ # Lists DataSources in a given project and location.
1280
+ #
1281
+ # @overload list_data_sources(request, options = nil)
1282
+ # Pass arguments to `list_data_sources` via a request object, either of type
1283
+ # {::Google::Cloud::BackupDR::V1::ListDataSourcesRequest} or an equivalent Hash.
1284
+ #
1285
+ # @param request [::Google::Cloud::BackupDR::V1::ListDataSourcesRequest, ::Hash]
1286
+ # A request object representing the call parameters. Required. To specify no
1287
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1288
+ # @param options [::Gapic::CallOptions, ::Hash]
1289
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1290
+ #
1291
+ # @overload list_data_sources(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1292
+ # Pass arguments to `list_data_sources` via keyword arguments. Note that at
1293
+ # least one keyword argument is required. To specify no parameters, or to keep all
1294
+ # the default parameter values, pass an empty Hash as a request object (see above).
1295
+ #
1296
+ # @param parent [::String]
1297
+ # Required. The project and location for which to retrieve data
1298
+ # sources information, in the format
1299
+ # 'projects/\\{project_id}/locations/\\{location}'. In Cloud Backup and DR,
1300
+ # locations map to Google Cloud regions, for example **us-central1**.
1301
+ # To retrieve data sources for all locations, use "-" for the
1302
+ # '\\{location}' value.
1303
+ # @param page_size [::Integer]
1304
+ # Optional. Requested page size. Server may return fewer items than
1305
+ # requested. If unspecified, server will pick an appropriate default.
1306
+ # @param page_token [::String]
1307
+ # Optional. A token identifying a page of results the server should return.
1308
+ # @param filter [::String]
1309
+ # Optional. Filtering results.
1310
+ # @param order_by [::String]
1311
+ # Optional. Hint for how to order the results.
1312
+ # @yield [result, operation] Access the result along with the TransportOperation object
1313
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::ListDataSourcesResponse]
1314
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1315
+ #
1316
+ # @return [::Google::Cloud::BackupDR::V1::ListDataSourcesResponse]
1317
+ #
1318
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1319
+ #
1320
+ # @example Basic example
1321
+ # require "google/cloud/backupdr/v1"
1322
+ #
1323
+ # # Create a client object. The client can be reused for multiple calls.
1324
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1325
+ #
1326
+ # # Create a request. To set request fields, pass in keyword arguments.
1327
+ # request = Google::Cloud::BackupDR::V1::ListDataSourcesRequest.new
1328
+ #
1329
+ # # Call the list_data_sources method.
1330
+ # result = client.list_data_sources request
1331
+ #
1332
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1333
+ # # over elements, and API calls will be issued to fetch pages as needed.
1334
+ # result.each do |item|
1335
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::DataSource.
1336
+ # p item
1337
+ # end
1338
+ #
1339
+ def list_data_sources request, options = nil
1340
+ raise ::ArgumentError, "request must be provided" if request.nil?
1341
+
1342
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::ListDataSourcesRequest
1343
+
1344
+ # Converts hash and nil to an options object
1345
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1346
+
1347
+ # Customize the options with defaults
1348
+ call_metadata = @config.rpcs.list_data_sources.metadata.to_h
1349
+
1350
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1351
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1352
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1353
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1354
+ transports_version_send: [:rest]
1355
+
1356
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1357
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1358
+
1359
+ options.apply_defaults timeout: @config.rpcs.list_data_sources.timeout,
1360
+ metadata: call_metadata,
1361
+ retry_policy: @config.rpcs.list_data_sources.retry_policy
1362
+
1363
+ options.apply_defaults timeout: @config.timeout,
1364
+ metadata: @config.metadata,
1365
+ retry_policy: @config.retry_policy
1366
+
1367
+ @backup_dr_stub.list_data_sources request, options do |result, operation|
1368
+ yield result, operation if block_given?
1369
+ return result
1370
+ end
1371
+ rescue ::Gapic::Rest::Error => e
1372
+ raise ::Google::Cloud::Error.from_error(e)
1373
+ end
1374
+
1375
+ ##
1376
+ # Gets details of a DataSource.
1377
+ #
1378
+ # @overload get_data_source(request, options = nil)
1379
+ # Pass arguments to `get_data_source` via a request object, either of type
1380
+ # {::Google::Cloud::BackupDR::V1::GetDataSourceRequest} or an equivalent Hash.
1381
+ #
1382
+ # @param request [::Google::Cloud::BackupDR::V1::GetDataSourceRequest, ::Hash]
1383
+ # A request object representing the call parameters. Required. To specify no
1384
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1385
+ # @param options [::Gapic::CallOptions, ::Hash]
1386
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1387
+ #
1388
+ # @overload get_data_source(name: nil)
1389
+ # Pass arguments to `get_data_source` via keyword arguments. Note that at
1390
+ # least one keyword argument is required. To specify no parameters, or to keep all
1391
+ # the default parameter values, pass an empty Hash as a request object (see above).
1392
+ #
1393
+ # @param name [::String]
1394
+ # Required. Name of the data source resource name, in the format
1395
+ # 'projects/\\{project_id}/locations/\\{location}/backupVaults/\\{resource_name}/dataSource/\\{resource_name}'
1396
+ # @yield [result, operation] Access the result along with the TransportOperation object
1397
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::DataSource]
1398
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1399
+ #
1400
+ # @return [::Google::Cloud::BackupDR::V1::DataSource]
1401
+ #
1402
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1403
+ #
1404
+ # @example Basic example
1405
+ # require "google/cloud/backupdr/v1"
1406
+ #
1407
+ # # Create a client object. The client can be reused for multiple calls.
1408
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1409
+ #
1410
+ # # Create a request. To set request fields, pass in keyword arguments.
1411
+ # request = Google::Cloud::BackupDR::V1::GetDataSourceRequest.new
1412
+ #
1413
+ # # Call the get_data_source method.
1414
+ # result = client.get_data_source request
1415
+ #
1416
+ # # The returned object is of type Google::Cloud::BackupDR::V1::DataSource.
1417
+ # p result
1418
+ #
1419
+ def get_data_source request, options = nil
1420
+ raise ::ArgumentError, "request must be provided" if request.nil?
1421
+
1422
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::GetDataSourceRequest
1423
+
1424
+ # Converts hash and nil to an options object
1425
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1426
+
1427
+ # Customize the options with defaults
1428
+ call_metadata = @config.rpcs.get_data_source.metadata.to_h
1429
+
1430
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1431
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1432
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1433
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1434
+ transports_version_send: [:rest]
1435
+
1436
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1437
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1438
+
1439
+ options.apply_defaults timeout: @config.rpcs.get_data_source.timeout,
1440
+ metadata: call_metadata,
1441
+ retry_policy: @config.rpcs.get_data_source.retry_policy
1442
+
1443
+ options.apply_defaults timeout: @config.timeout,
1444
+ metadata: @config.metadata,
1445
+ retry_policy: @config.retry_policy
1446
+
1447
+ @backup_dr_stub.get_data_source request, options do |result, operation|
1448
+ yield result, operation if block_given?
1449
+ return result
1450
+ end
1451
+ rescue ::Gapic::Rest::Error => e
1452
+ raise ::Google::Cloud::Error.from_error(e)
1453
+ end
1454
+
1455
+ ##
1456
+ # Updates the settings of a DataSource.
1457
+ #
1458
+ # @overload update_data_source(request, options = nil)
1459
+ # Pass arguments to `update_data_source` via a request object, either of type
1460
+ # {::Google::Cloud::BackupDR::V1::UpdateDataSourceRequest} or an equivalent Hash.
1461
+ #
1462
+ # @param request [::Google::Cloud::BackupDR::V1::UpdateDataSourceRequest, ::Hash]
1463
+ # A request object representing the call parameters. Required. To specify no
1464
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1465
+ # @param options [::Gapic::CallOptions, ::Hash]
1466
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1467
+ #
1468
+ # @overload update_data_source(update_mask: nil, data_source: nil, request_id: nil, allow_missing: nil)
1469
+ # Pass arguments to `update_data_source` via keyword arguments. Note that at
1470
+ # least one keyword argument is required. To specify no parameters, or to keep all
1471
+ # the default parameter values, pass an empty Hash as a request object (see above).
1472
+ #
1473
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1474
+ # Required. Field mask is used to specify the fields to be overwritten in the
1475
+ # DataSource resource by the update.
1476
+ # The fields specified in the update_mask are relative to the resource, not
1477
+ # the full request. A field will be overwritten if it is in the mask. If the
1478
+ # user does not provide a mask then the request will fail.
1479
+ # @param data_source [::Google::Cloud::BackupDR::V1::DataSource, ::Hash]
1480
+ # Required. The resource being updated
1481
+ # @param request_id [::String]
1482
+ # Optional. An optional request ID to identify requests. Specify a unique
1483
+ # request ID so that if you must retry your request, the server will know to
1484
+ # ignore the request if it has already been completed. The server will
1485
+ # guarantee that for at least 60 minutes since the first request.
1486
+ #
1487
+ # For example, consider a situation where you make an initial request and
1488
+ # the request times out. If you make the request again with the same request
1489
+ # ID, the server can check if original operation with the same request ID
1490
+ # was received, and if so, will ignore the second request. This prevents
1491
+ # clients from accidentally creating duplicate commitments.
1492
+ #
1493
+ # The request ID must be a valid UUID with the exception that zero UUID is
1494
+ # not supported (00000000-0000-0000-0000-000000000000).
1495
+ # @param allow_missing [::Boolean]
1496
+ # Optional. Enable upsert.
1497
+ # @yield [result, operation] Access the result along with the TransportOperation object
1498
+ # @yieldparam result [::Gapic::Operation]
1499
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1500
+ #
1501
+ # @return [::Gapic::Operation]
1502
+ #
1503
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1504
+ #
1505
+ # @example Basic example
1506
+ # require "google/cloud/backupdr/v1"
1507
+ #
1508
+ # # Create a client object. The client can be reused for multiple calls.
1509
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1510
+ #
1511
+ # # Create a request. To set request fields, pass in keyword arguments.
1512
+ # request = Google::Cloud::BackupDR::V1::UpdateDataSourceRequest.new
1513
+ #
1514
+ # # Call the update_data_source method.
1515
+ # result = client.update_data_source request
1516
+ #
1517
+ # # The returned object is of type Gapic::Operation. You can use it to
1518
+ # # check the status of an operation, cancel it, or wait for results.
1519
+ # # Here is how to wait for a response.
1520
+ # result.wait_until_done! timeout: 60
1521
+ # if result.response?
1522
+ # p result.response
1523
+ # else
1524
+ # puts "No response received."
1525
+ # end
1526
+ #
1527
+ def update_data_source request, options = nil
1528
+ raise ::ArgumentError, "request must be provided" if request.nil?
1529
+
1530
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::UpdateDataSourceRequest
1531
+
1532
+ # Converts hash and nil to an options object
1533
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1534
+
1535
+ # Customize the options with defaults
1536
+ call_metadata = @config.rpcs.update_data_source.metadata.to_h
1537
+
1538
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1539
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1540
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1541
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1542
+ transports_version_send: [:rest]
1543
+
1544
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1545
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1546
+
1547
+ options.apply_defaults timeout: @config.rpcs.update_data_source.timeout,
1548
+ metadata: call_metadata,
1549
+ retry_policy: @config.rpcs.update_data_source.retry_policy
1550
+
1551
+ options.apply_defaults timeout: @config.timeout,
1552
+ metadata: @config.metadata,
1553
+ retry_policy: @config.retry_policy
1554
+
1555
+ @backup_dr_stub.update_data_source request, options do |result, operation|
1556
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1557
+ yield result, operation if block_given?
1558
+ return result
1559
+ end
1560
+ rescue ::Gapic::Rest::Error => e
1561
+ raise ::Google::Cloud::Error.from_error(e)
1562
+ end
1563
+
1564
+ ##
1565
+ # Lists Backups in a given project and location.
1566
+ #
1567
+ # @overload list_backups(request, options = nil)
1568
+ # Pass arguments to `list_backups` via a request object, either of type
1569
+ # {::Google::Cloud::BackupDR::V1::ListBackupsRequest} or an equivalent Hash.
1570
+ #
1571
+ # @param request [::Google::Cloud::BackupDR::V1::ListBackupsRequest, ::Hash]
1572
+ # A request object representing the call parameters. Required. To specify no
1573
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1574
+ # @param options [::Gapic::CallOptions, ::Hash]
1575
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1576
+ #
1577
+ # @overload list_backups(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, view: nil)
1578
+ # Pass arguments to `list_backups` via keyword arguments. Note that at
1579
+ # least one keyword argument is required. To specify no parameters, or to keep all
1580
+ # the default parameter values, pass an empty Hash as a request object (see above).
1581
+ #
1582
+ # @param parent [::String]
1583
+ # Required. The project and location for which to retrieve backup
1584
+ # information, in the format
1585
+ # 'projects/\\{project_id}/locations/\\{location}'. In Cloud Backup and DR,
1586
+ # locations map to Google Cloud regions, for example **us-central1**.
1587
+ # To retrieve data sources for all locations, use "-" for the
1588
+ # '\\{location}' value.
1589
+ # @param page_size [::Integer]
1590
+ # Optional. Requested page size. Server may return fewer items than
1591
+ # requested. If unspecified, server will pick an appropriate default.
1592
+ # @param page_token [::String]
1593
+ # Optional. A token identifying a page of results the server should return.
1594
+ # @param filter [::String]
1595
+ # Optional. Filtering results.
1596
+ # @param order_by [::String]
1597
+ # Optional. Hint for how to order the results.
1598
+ # @param view [::Google::Cloud::BackupDR::V1::BackupView]
1599
+ # Optional. Reserved for future use to provide a BASIC & FULL view of Backup
1600
+ # resource.
1601
+ # @yield [result, operation] Access the result along with the TransportOperation object
1602
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::ListBackupsResponse]
1603
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1604
+ #
1605
+ # @return [::Google::Cloud::BackupDR::V1::ListBackupsResponse]
1606
+ #
1607
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1608
+ #
1609
+ # @example Basic example
1610
+ # require "google/cloud/backupdr/v1"
1611
+ #
1612
+ # # Create a client object. The client can be reused for multiple calls.
1613
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1614
+ #
1615
+ # # Create a request. To set request fields, pass in keyword arguments.
1616
+ # request = Google::Cloud::BackupDR::V1::ListBackupsRequest.new
1617
+ #
1618
+ # # Call the list_backups method.
1619
+ # result = client.list_backups request
1620
+ #
1621
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1622
+ # # over elements, and API calls will be issued to fetch pages as needed.
1623
+ # result.each do |item|
1624
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::Backup.
1625
+ # p item
1626
+ # end
1627
+ #
1628
+ def list_backups request, options = nil
1629
+ raise ::ArgumentError, "request must be provided" if request.nil?
1630
+
1631
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::ListBackupsRequest
1632
+
1633
+ # Converts hash and nil to an options object
1634
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1635
+
1636
+ # Customize the options with defaults
1637
+ call_metadata = @config.rpcs.list_backups.metadata.to_h
1638
+
1639
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1640
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1641
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1642
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1643
+ transports_version_send: [:rest]
1644
+
1645
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1646
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1647
+
1648
+ options.apply_defaults timeout: @config.rpcs.list_backups.timeout,
1649
+ metadata: call_metadata,
1650
+ retry_policy: @config.rpcs.list_backups.retry_policy
1651
+
1652
+ options.apply_defaults timeout: @config.timeout,
1653
+ metadata: @config.metadata,
1654
+ retry_policy: @config.retry_policy
1655
+
1656
+ @backup_dr_stub.list_backups request, options do |result, operation|
1657
+ yield result, operation if block_given?
1658
+ return result
1659
+ end
1660
+ rescue ::Gapic::Rest::Error => e
1661
+ raise ::Google::Cloud::Error.from_error(e)
1662
+ end
1663
+
1664
+ ##
1665
+ # Gets details of a Backup.
1666
+ #
1667
+ # @overload get_backup(request, options = nil)
1668
+ # Pass arguments to `get_backup` via a request object, either of type
1669
+ # {::Google::Cloud::BackupDR::V1::GetBackupRequest} or an equivalent Hash.
1670
+ #
1671
+ # @param request [::Google::Cloud::BackupDR::V1::GetBackupRequest, ::Hash]
1672
+ # A request object representing the call parameters. Required. To specify no
1673
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1674
+ # @param options [::Gapic::CallOptions, ::Hash]
1675
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1676
+ #
1677
+ # @overload get_backup(name: nil, view: nil)
1678
+ # Pass arguments to `get_backup` via keyword arguments. Note that at
1679
+ # least one keyword argument is required. To specify no parameters, or to keep all
1680
+ # the default parameter values, pass an empty Hash as a request object (see above).
1681
+ #
1682
+ # @param name [::String]
1683
+ # Required. Name of the data source resource name, in the format
1684
+ # 'projects/\\{project_id}/locations/\\{location}/backupVaults/\\{backupVault}/dataSources/\\{datasource}/backups/\\{backup}'
1685
+ # @param view [::Google::Cloud::BackupDR::V1::BackupView]
1686
+ # Optional. Reserved for future use to provide a BASIC & FULL view of Backup
1687
+ # resource.
1688
+ # @yield [result, operation] Access the result along with the TransportOperation object
1689
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::Backup]
1690
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1691
+ #
1692
+ # @return [::Google::Cloud::BackupDR::V1::Backup]
1693
+ #
1694
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1695
+ #
1696
+ # @example Basic example
1697
+ # require "google/cloud/backupdr/v1"
1698
+ #
1699
+ # # Create a client object. The client can be reused for multiple calls.
1700
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1701
+ #
1702
+ # # Create a request. To set request fields, pass in keyword arguments.
1703
+ # request = Google::Cloud::BackupDR::V1::GetBackupRequest.new
1704
+ #
1705
+ # # Call the get_backup method.
1706
+ # result = client.get_backup request
1707
+ #
1708
+ # # The returned object is of type Google::Cloud::BackupDR::V1::Backup.
1709
+ # p result
1710
+ #
1711
+ def get_backup request, options = nil
1712
+ raise ::ArgumentError, "request must be provided" if request.nil?
1713
+
1714
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::GetBackupRequest
1715
+
1716
+ # Converts hash and nil to an options object
1717
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1718
+
1719
+ # Customize the options with defaults
1720
+ call_metadata = @config.rpcs.get_backup.metadata.to_h
1721
+
1722
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1723
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1724
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1725
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1726
+ transports_version_send: [:rest]
1727
+
1728
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1729
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1730
+
1731
+ options.apply_defaults timeout: @config.rpcs.get_backup.timeout,
1732
+ metadata: call_metadata,
1733
+ retry_policy: @config.rpcs.get_backup.retry_policy
1734
+
1735
+ options.apply_defaults timeout: @config.timeout,
1736
+ metadata: @config.metadata,
1737
+ retry_policy: @config.retry_policy
1738
+
1739
+ @backup_dr_stub.get_backup request, options do |result, operation|
1740
+ yield result, operation if block_given?
1741
+ return result
1742
+ end
1743
+ rescue ::Gapic::Rest::Error => e
1744
+ raise ::Google::Cloud::Error.from_error(e)
1745
+ end
1746
+
1747
+ ##
1748
+ # Updates the settings of a Backup.
1749
+ #
1750
+ # @overload update_backup(request, options = nil)
1751
+ # Pass arguments to `update_backup` via a request object, either of type
1752
+ # {::Google::Cloud::BackupDR::V1::UpdateBackupRequest} or an equivalent Hash.
1753
+ #
1754
+ # @param request [::Google::Cloud::BackupDR::V1::UpdateBackupRequest, ::Hash]
1755
+ # A request object representing the call parameters. Required. To specify no
1756
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1757
+ # @param options [::Gapic::CallOptions, ::Hash]
1758
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1759
+ #
1760
+ # @overload update_backup(update_mask: nil, backup: nil, request_id: nil)
1761
+ # Pass arguments to `update_backup` via keyword arguments. Note that at
1762
+ # least one keyword argument is required. To specify no parameters, or to keep all
1763
+ # the default parameter values, pass an empty Hash as a request object (see above).
1764
+ #
1765
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1766
+ # Required. Field mask is used to specify the fields to be overwritten in the
1767
+ # Backup resource by the update.
1768
+ # The fields specified in the update_mask are relative to the resource, not
1769
+ # the full request. A field will be overwritten if it is in the mask. If the
1770
+ # user does not provide a mask then the request will fail.
1771
+ # @param backup [::Google::Cloud::BackupDR::V1::Backup, ::Hash]
1772
+ # Required. The resource being updated
1773
+ # @param request_id [::String]
1774
+ # Optional. An optional request ID to identify requests. Specify a unique
1775
+ # request ID so that if you must retry your request, the server will know to
1776
+ # ignore the request if it has already been completed. The server will
1777
+ # guarantee that for at least 60 minutes since the first request.
1778
+ #
1779
+ # For example, consider a situation where you make an initial request and
1780
+ # the request times out. If you make the request again with the same request
1781
+ # ID, the server can check if original operation with the same request ID
1782
+ # was received, and if so, will ignore the second request. This prevents
1783
+ # clients from accidentally creating duplicate commitments.
1784
+ #
1785
+ # The request ID must be a valid UUID with the exception that zero UUID is
1786
+ # not supported (00000000-0000-0000-0000-000000000000).
1787
+ # @yield [result, operation] Access the result along with the TransportOperation object
1788
+ # @yieldparam result [::Gapic::Operation]
1789
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1790
+ #
1791
+ # @return [::Gapic::Operation]
1792
+ #
1793
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1794
+ #
1795
+ # @example Basic example
1796
+ # require "google/cloud/backupdr/v1"
1797
+ #
1798
+ # # Create a client object. The client can be reused for multiple calls.
1799
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1800
+ #
1801
+ # # Create a request. To set request fields, pass in keyword arguments.
1802
+ # request = Google::Cloud::BackupDR::V1::UpdateBackupRequest.new
1803
+ #
1804
+ # # Call the update_backup method.
1805
+ # result = client.update_backup request
1806
+ #
1807
+ # # The returned object is of type Gapic::Operation. You can use it to
1808
+ # # check the status of an operation, cancel it, or wait for results.
1809
+ # # Here is how to wait for a response.
1810
+ # result.wait_until_done! timeout: 60
1811
+ # if result.response?
1812
+ # p result.response
1813
+ # else
1814
+ # puts "No response received."
1815
+ # end
1816
+ #
1817
+ def update_backup request, options = nil
1818
+ raise ::ArgumentError, "request must be provided" if request.nil?
1819
+
1820
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::UpdateBackupRequest
1821
+
1822
+ # Converts hash and nil to an options object
1823
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1824
+
1825
+ # Customize the options with defaults
1826
+ call_metadata = @config.rpcs.update_backup.metadata.to_h
1827
+
1828
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1829
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1830
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1831
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1832
+ transports_version_send: [:rest]
1833
+
1834
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1835
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1836
+
1837
+ options.apply_defaults timeout: @config.rpcs.update_backup.timeout,
1838
+ metadata: call_metadata,
1839
+ retry_policy: @config.rpcs.update_backup.retry_policy
1840
+
1841
+ options.apply_defaults timeout: @config.timeout,
1842
+ metadata: @config.metadata,
1843
+ retry_policy: @config.retry_policy
1844
+
1845
+ @backup_dr_stub.update_backup request, options do |result, operation|
1846
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1847
+ yield result, operation if block_given?
1848
+ return result
1849
+ end
1850
+ rescue ::Gapic::Rest::Error => e
1851
+ raise ::Google::Cloud::Error.from_error(e)
1852
+ end
1853
+
1854
+ ##
1855
+ # Deletes a Backup.
1856
+ #
1857
+ # @overload delete_backup(request, options = nil)
1858
+ # Pass arguments to `delete_backup` via a request object, either of type
1859
+ # {::Google::Cloud::BackupDR::V1::DeleteBackupRequest} or an equivalent Hash.
1860
+ #
1861
+ # @param request [::Google::Cloud::BackupDR::V1::DeleteBackupRequest, ::Hash]
1862
+ # A request object representing the call parameters. Required. To specify no
1863
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1864
+ # @param options [::Gapic::CallOptions, ::Hash]
1865
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1866
+ #
1867
+ # @overload delete_backup(name: nil, request_id: nil)
1868
+ # Pass arguments to `delete_backup` via keyword arguments. Note that at
1869
+ # least one keyword argument is required. To specify no parameters, or to keep all
1870
+ # the default parameter values, pass an empty Hash as a request object (see above).
1871
+ #
1872
+ # @param name [::String]
1873
+ # Required. Name of the resource.
1874
+ # @param request_id [::String]
1875
+ # Optional. An optional request ID to identify requests. Specify a unique
1876
+ # request ID so that if you must retry your request, the server will know to
1877
+ # ignore the request if it has already been completed. The server will
1878
+ # guarantee that for at least 60 minutes after the first request.
1879
+ #
1880
+ # For example, consider a situation where you make an initial request and
1881
+ # the request times out. If you make the request again with the same request
1882
+ # ID, the server can check if original operation with the same request ID
1883
+ # was received, and if so, will ignore the second request. This prevents
1884
+ # clients from accidentally creating duplicate commitments.
1885
+ #
1886
+ # The request ID must be a valid UUID with the exception that zero UUID is
1887
+ # not supported (00000000-0000-0000-0000-000000000000).
1888
+ # @yield [result, operation] Access the result along with the TransportOperation object
1889
+ # @yieldparam result [::Gapic::Operation]
1890
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1891
+ #
1892
+ # @return [::Gapic::Operation]
1893
+ #
1894
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1895
+ #
1896
+ # @example Basic example
1897
+ # require "google/cloud/backupdr/v1"
1898
+ #
1899
+ # # Create a client object. The client can be reused for multiple calls.
1900
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
1901
+ #
1902
+ # # Create a request. To set request fields, pass in keyword arguments.
1903
+ # request = Google::Cloud::BackupDR::V1::DeleteBackupRequest.new
1904
+ #
1905
+ # # Call the delete_backup method.
1906
+ # result = client.delete_backup request
1907
+ #
1908
+ # # The returned object is of type Gapic::Operation. You can use it to
1909
+ # # check the status of an operation, cancel it, or wait for results.
1910
+ # # Here is how to wait for a response.
1911
+ # result.wait_until_done! timeout: 60
1912
+ # if result.response?
1913
+ # p result.response
1914
+ # else
1915
+ # puts "No response received."
1916
+ # end
1917
+ #
1918
+ def delete_backup request, options = nil
1919
+ raise ::ArgumentError, "request must be provided" if request.nil?
1920
+
1921
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::DeleteBackupRequest
1922
+
1923
+ # Converts hash and nil to an options object
1924
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1925
+
1926
+ # Customize the options with defaults
1927
+ call_metadata = @config.rpcs.delete_backup.metadata.to_h
1928
+
1929
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1930
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1931
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1932
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
1933
+ transports_version_send: [:rest]
1934
+
1935
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1936
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1937
+
1938
+ options.apply_defaults timeout: @config.rpcs.delete_backup.timeout,
1939
+ metadata: call_metadata,
1940
+ retry_policy: @config.rpcs.delete_backup.retry_policy
1941
+
1942
+ options.apply_defaults timeout: @config.timeout,
1943
+ metadata: @config.metadata,
1944
+ retry_policy: @config.retry_policy
1945
+
1946
+ @backup_dr_stub.delete_backup request, options do |result, operation|
1947
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1948
+ yield result, operation if block_given?
1949
+ return result
1950
+ end
1951
+ rescue ::Gapic::Rest::Error => e
1952
+ raise ::Google::Cloud::Error.from_error(e)
1953
+ end
1954
+
1955
+ ##
1956
+ # Restore from a Backup
1957
+ #
1958
+ # @overload restore_backup(request, options = nil)
1959
+ # Pass arguments to `restore_backup` via a request object, either of type
1960
+ # {::Google::Cloud::BackupDR::V1::RestoreBackupRequest} or an equivalent Hash.
1961
+ #
1962
+ # @param request [::Google::Cloud::BackupDR::V1::RestoreBackupRequest, ::Hash]
1963
+ # A request object representing the call parameters. Required. To specify no
1964
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1965
+ # @param options [::Gapic::CallOptions, ::Hash]
1966
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1967
+ #
1968
+ # @overload restore_backup(name: nil, request_id: nil, compute_instance_target_environment: nil, compute_instance_restore_properties: nil)
1969
+ # Pass arguments to `restore_backup` via keyword arguments. Note that at
1970
+ # least one keyword argument is required. To specify no parameters, or to keep all
1971
+ # the default parameter values, pass an empty Hash as a request object (see above).
1972
+ #
1973
+ # @param name [::String]
1974
+ # Required. The resource name of the Backup instance, in the format
1975
+ # 'projects/*/locations/*/backupVaults/*/dataSources/*/backups/'.
1976
+ # @param request_id [::String]
1977
+ # Optional. An optional request ID to identify requests. Specify a unique
1978
+ # request ID so that if you must retry your request, the server will know to
1979
+ # ignore the request if it has already been completed. The server will
1980
+ # guarantee that for at least 60 minutes after the first request.
1981
+ #
1982
+ # For example, consider a situation where you make an initial request and
1983
+ # the request times out. If you make the request again with the same request
1984
+ # ID, the server can check if original operation with the same request ID
1985
+ # was received, and if so, will ignore the second request. This prevents
1986
+ # clients from accidentally creating duplicate commitments.
1987
+ #
1988
+ # The request ID must be a valid UUID with the exception that zero UUID is
1989
+ # not supported (00000000-0000-0000-0000-000000000000).
1990
+ # @param compute_instance_target_environment [::Google::Cloud::BackupDR::V1::ComputeInstanceTargetEnvironment, ::Hash]
1991
+ # Compute Engine target environment to be used during restore.
1992
+ # @param compute_instance_restore_properties [::Google::Cloud::BackupDR::V1::ComputeInstanceRestoreProperties, ::Hash]
1993
+ # Compute Engine instance properties to be overridden during restore.
1994
+ # @yield [result, operation] Access the result along with the TransportOperation object
1995
+ # @yieldparam result [::Gapic::Operation]
1996
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1997
+ #
1998
+ # @return [::Gapic::Operation]
1999
+ #
2000
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2001
+ #
2002
+ # @example Basic example
2003
+ # require "google/cloud/backupdr/v1"
2004
+ #
2005
+ # # Create a client object. The client can be reused for multiple calls.
2006
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2007
+ #
2008
+ # # Create a request. To set request fields, pass in keyword arguments.
2009
+ # request = Google::Cloud::BackupDR::V1::RestoreBackupRequest.new
2010
+ #
2011
+ # # Call the restore_backup method.
2012
+ # result = client.restore_backup request
2013
+ #
2014
+ # # The returned object is of type Gapic::Operation. You can use it to
2015
+ # # check the status of an operation, cancel it, or wait for results.
2016
+ # # Here is how to wait for a response.
2017
+ # result.wait_until_done! timeout: 60
2018
+ # if result.response?
2019
+ # p result.response
2020
+ # else
2021
+ # puts "No response received."
2022
+ # end
2023
+ #
2024
+ def restore_backup request, options = nil
2025
+ raise ::ArgumentError, "request must be provided" if request.nil?
2026
+
2027
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::RestoreBackupRequest
2028
+
2029
+ # Converts hash and nil to an options object
2030
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2031
+
2032
+ # Customize the options with defaults
2033
+ call_metadata = @config.rpcs.restore_backup.metadata.to_h
2034
+
2035
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2036
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2037
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2038
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2039
+ transports_version_send: [:rest]
2040
+
2041
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2042
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2043
+
2044
+ options.apply_defaults timeout: @config.rpcs.restore_backup.timeout,
2045
+ metadata: call_metadata,
2046
+ retry_policy: @config.rpcs.restore_backup.retry_policy
2047
+
2048
+ options.apply_defaults timeout: @config.timeout,
2049
+ metadata: @config.metadata,
2050
+ retry_policy: @config.retry_policy
2051
+
2052
+ @backup_dr_stub.restore_backup request, options do |result, operation|
2053
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2054
+ yield result, operation if block_given?
2055
+ return result
2056
+ end
2057
+ rescue ::Gapic::Rest::Error => e
2058
+ raise ::Google::Cloud::Error.from_error(e)
2059
+ end
2060
+
2061
+ ##
2062
+ # Create a BackupPlan
2063
+ #
2064
+ # @overload create_backup_plan(request, options = nil)
2065
+ # Pass arguments to `create_backup_plan` via a request object, either of type
2066
+ # {::Google::Cloud::BackupDR::V1::CreateBackupPlanRequest} or an equivalent Hash.
2067
+ #
2068
+ # @param request [::Google::Cloud::BackupDR::V1::CreateBackupPlanRequest, ::Hash]
2069
+ # A request object representing the call parameters. Required. To specify no
2070
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2071
+ # @param options [::Gapic::CallOptions, ::Hash]
2072
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2073
+ #
2074
+ # @overload create_backup_plan(parent: nil, backup_plan_id: nil, backup_plan: nil, request_id: nil)
2075
+ # Pass arguments to `create_backup_plan` via keyword arguments. Note that at
2076
+ # least one keyword argument is required. To specify no parameters, or to keep all
2077
+ # the default parameter values, pass an empty Hash as a request object (see above).
2078
+ #
2079
+ # @param parent [::String]
2080
+ # Required. The `BackupPlan` project and location in the format
2081
+ # `projects/{project}/locations/{location}`. In Cloud BackupDR locations
2082
+ # map to GCP regions, for example **us-central1**.
2083
+ # @param backup_plan_id [::String]
2084
+ # Required. The name of the `BackupPlan` to create. The name must be unique
2085
+ # for the specified project and location.The name must start with a lowercase
2086
+ # letter followed by up to 62 lowercase letters, numbers, or hyphens.
2087
+ # Pattern, /[a-z][a-z0-9-]\\{,62}/.
2088
+ # @param backup_plan [::Google::Cloud::BackupDR::V1::BackupPlan, ::Hash]
2089
+ # Required. The `BackupPlan` resource object to create.
2090
+ # @param request_id [::String]
2091
+ # Optional. An optional request ID to identify requests. Specify a unique
2092
+ # request ID so that if you must retry your request, the server will know to
2093
+ # ignore the request if it has already been completed. The server will
2094
+ # guarantee that for at least 60 minutes since the first request.
2095
+ #
2096
+ # For example, consider a situation where you make an initial request and t
2097
+ # he request times out. If you make the request again with the same request
2098
+ # ID, the server can check if original operation with the same request ID
2099
+ # was received, and if so, will ignore the second request. This prevents
2100
+ # clients from accidentally creating duplicate commitments.
2101
+ #
2102
+ # The request ID must be a valid UUID with the exception that zero UUID is
2103
+ # not supported (00000000-0000-0000-0000-000000000000).
2104
+ # @yield [result, operation] Access the result along with the TransportOperation object
2105
+ # @yieldparam result [::Gapic::Operation]
2106
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2107
+ #
2108
+ # @return [::Gapic::Operation]
2109
+ #
2110
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2111
+ #
2112
+ # @example Basic example
2113
+ # require "google/cloud/backupdr/v1"
2114
+ #
2115
+ # # Create a client object. The client can be reused for multiple calls.
2116
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2117
+ #
2118
+ # # Create a request. To set request fields, pass in keyword arguments.
2119
+ # request = Google::Cloud::BackupDR::V1::CreateBackupPlanRequest.new
2120
+ #
2121
+ # # Call the create_backup_plan method.
2122
+ # result = client.create_backup_plan request
2123
+ #
2124
+ # # The returned object is of type Gapic::Operation. You can use it to
2125
+ # # check the status of an operation, cancel it, or wait for results.
2126
+ # # Here is how to wait for a response.
2127
+ # result.wait_until_done! timeout: 60
2128
+ # if result.response?
2129
+ # p result.response
2130
+ # else
2131
+ # puts "No response received."
2132
+ # end
2133
+ #
2134
+ def create_backup_plan request, options = nil
2135
+ raise ::ArgumentError, "request must be provided" if request.nil?
2136
+
2137
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::CreateBackupPlanRequest
2138
+
2139
+ # Converts hash and nil to an options object
2140
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2141
+
2142
+ # Customize the options with defaults
2143
+ call_metadata = @config.rpcs.create_backup_plan.metadata.to_h
2144
+
2145
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2146
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2147
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2148
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2149
+ transports_version_send: [:rest]
2150
+
2151
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2152
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2153
+
2154
+ options.apply_defaults timeout: @config.rpcs.create_backup_plan.timeout,
2155
+ metadata: call_metadata,
2156
+ retry_policy: @config.rpcs.create_backup_plan.retry_policy
2157
+
2158
+ options.apply_defaults timeout: @config.timeout,
2159
+ metadata: @config.metadata,
2160
+ retry_policy: @config.retry_policy
2161
+
2162
+ @backup_dr_stub.create_backup_plan request, options do |result, operation|
2163
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2164
+ yield result, operation if block_given?
2165
+ return result
2166
+ end
2167
+ rescue ::Gapic::Rest::Error => e
2168
+ raise ::Google::Cloud::Error.from_error(e)
2169
+ end
2170
+
2171
+ ##
2172
+ # Gets details of a single BackupPlan.
2173
+ #
2174
+ # @overload get_backup_plan(request, options = nil)
2175
+ # Pass arguments to `get_backup_plan` via a request object, either of type
2176
+ # {::Google::Cloud::BackupDR::V1::GetBackupPlanRequest} or an equivalent Hash.
2177
+ #
2178
+ # @param request [::Google::Cloud::BackupDR::V1::GetBackupPlanRequest, ::Hash]
2179
+ # A request object representing the call parameters. Required. To specify no
2180
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2181
+ # @param options [::Gapic::CallOptions, ::Hash]
2182
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2183
+ #
2184
+ # @overload get_backup_plan(name: nil)
2185
+ # Pass arguments to `get_backup_plan` via keyword arguments. Note that at
2186
+ # least one keyword argument is required. To specify no parameters, or to keep all
2187
+ # the default parameter values, pass an empty Hash as a request object (see above).
2188
+ #
2189
+ # @param name [::String]
2190
+ # Required. The resource name of the `BackupPlan` to retrieve.
2191
+ #
2192
+ # Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}`
2193
+ # @yield [result, operation] Access the result along with the TransportOperation object
2194
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::BackupPlan]
2195
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2196
+ #
2197
+ # @return [::Google::Cloud::BackupDR::V1::BackupPlan]
2198
+ #
2199
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2200
+ #
2201
+ # @example Basic example
2202
+ # require "google/cloud/backupdr/v1"
2203
+ #
2204
+ # # Create a client object. The client can be reused for multiple calls.
2205
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2206
+ #
2207
+ # # Create a request. To set request fields, pass in keyword arguments.
2208
+ # request = Google::Cloud::BackupDR::V1::GetBackupPlanRequest.new
2209
+ #
2210
+ # # Call the get_backup_plan method.
2211
+ # result = client.get_backup_plan request
2212
+ #
2213
+ # # The returned object is of type Google::Cloud::BackupDR::V1::BackupPlan.
2214
+ # p result
2215
+ #
2216
+ def get_backup_plan request, options = nil
2217
+ raise ::ArgumentError, "request must be provided" if request.nil?
2218
+
2219
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::GetBackupPlanRequest
2220
+
2221
+ # Converts hash and nil to an options object
2222
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2223
+
2224
+ # Customize the options with defaults
2225
+ call_metadata = @config.rpcs.get_backup_plan.metadata.to_h
2226
+
2227
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2228
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2229
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2230
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2231
+ transports_version_send: [:rest]
2232
+
2233
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2234
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2235
+
2236
+ options.apply_defaults timeout: @config.rpcs.get_backup_plan.timeout,
2237
+ metadata: call_metadata,
2238
+ retry_policy: @config.rpcs.get_backup_plan.retry_policy
2239
+
2240
+ options.apply_defaults timeout: @config.timeout,
2241
+ metadata: @config.metadata,
2242
+ retry_policy: @config.retry_policy
2243
+
2244
+ @backup_dr_stub.get_backup_plan request, options do |result, operation|
2245
+ yield result, operation if block_given?
2246
+ return result
2247
+ end
2248
+ rescue ::Gapic::Rest::Error => e
2249
+ raise ::Google::Cloud::Error.from_error(e)
2250
+ end
2251
+
2252
+ ##
2253
+ # Lists BackupPlans in a given project and location.
2254
+ #
2255
+ # @overload list_backup_plans(request, options = nil)
2256
+ # Pass arguments to `list_backup_plans` via a request object, either of type
2257
+ # {::Google::Cloud::BackupDR::V1::ListBackupPlansRequest} or an equivalent Hash.
2258
+ #
2259
+ # @param request [::Google::Cloud::BackupDR::V1::ListBackupPlansRequest, ::Hash]
2260
+ # A request object representing the call parameters. Required. To specify no
2261
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2262
+ # @param options [::Gapic::CallOptions, ::Hash]
2263
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2264
+ #
2265
+ # @overload list_backup_plans(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
2266
+ # Pass arguments to `list_backup_plans` via keyword arguments. Note that at
2267
+ # least one keyword argument is required. To specify no parameters, or to keep all
2268
+ # the default parameter values, pass an empty Hash as a request object (see above).
2269
+ #
2270
+ # @param parent [::String]
2271
+ # Required. The project and location for which to retrieve `BackupPlans`
2272
+ # information. Format: `projects/{project}/locations/{location}`. In Cloud
2273
+ # BackupDR, locations map to GCP regions, for e.g. **us-central1**. To
2274
+ # retrieve backup plans for all locations, use "-" for the
2275
+ # `{location}` value.
2276
+ # @param page_size [::Integer]
2277
+ # Optional. The maximum number of `BackupPlans` to return in a single
2278
+ # response. If not specified, a default value will be chosen by the service.
2279
+ # Note that the response may include a partial list and a caller should
2280
+ # only rely on the response's
2281
+ # {::Google::Cloud::BackupDR::V1::ListBackupPlansResponse#next_page_token next_page_token}
2282
+ # to determine if there are more instances left to be queried.
2283
+ # @param page_token [::String]
2284
+ # Optional. The value of
2285
+ # {::Google::Cloud::BackupDR::V1::ListBackupPlansResponse#next_page_token next_page_token}
2286
+ # received from a previous `ListBackupPlans` call.
2287
+ # Provide this to retrieve the subsequent page in a multi-page list of
2288
+ # results. When paginating, all other parameters provided to
2289
+ # `ListBackupPlans` must match the call that provided the page token.
2290
+ # @param filter [::String]
2291
+ # Optional. Field match expression used to filter the results.
2292
+ # @param order_by [::String]
2293
+ # Optional. Field by which to sort the results.
2294
+ # @yield [result, operation] Access the result along with the TransportOperation object
2295
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::ListBackupPlansResponse]
2296
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2297
+ #
2298
+ # @return [::Google::Cloud::BackupDR::V1::ListBackupPlansResponse]
2299
+ #
2300
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2301
+ #
2302
+ # @example Basic example
2303
+ # require "google/cloud/backupdr/v1"
2304
+ #
2305
+ # # Create a client object. The client can be reused for multiple calls.
2306
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2307
+ #
2308
+ # # Create a request. To set request fields, pass in keyword arguments.
2309
+ # request = Google::Cloud::BackupDR::V1::ListBackupPlansRequest.new
2310
+ #
2311
+ # # Call the list_backup_plans method.
2312
+ # result = client.list_backup_plans request
2313
+ #
2314
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2315
+ # # over elements, and API calls will be issued to fetch pages as needed.
2316
+ # result.each do |item|
2317
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::BackupPlan.
2318
+ # p item
2319
+ # end
2320
+ #
2321
+ def list_backup_plans request, options = nil
2322
+ raise ::ArgumentError, "request must be provided" if request.nil?
2323
+
2324
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::ListBackupPlansRequest
2325
+
2326
+ # Converts hash and nil to an options object
2327
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2328
+
2329
+ # Customize the options with defaults
2330
+ call_metadata = @config.rpcs.list_backup_plans.metadata.to_h
2331
+
2332
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2333
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2334
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2335
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2336
+ transports_version_send: [:rest]
2337
+
2338
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2339
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2340
+
2341
+ options.apply_defaults timeout: @config.rpcs.list_backup_plans.timeout,
2342
+ metadata: call_metadata,
2343
+ retry_policy: @config.rpcs.list_backup_plans.retry_policy
2344
+
2345
+ options.apply_defaults timeout: @config.timeout,
2346
+ metadata: @config.metadata,
2347
+ retry_policy: @config.retry_policy
2348
+
2349
+ @backup_dr_stub.list_backup_plans request, options do |result, operation|
2350
+ yield result, operation if block_given?
2351
+ return result
2352
+ end
2353
+ rescue ::Gapic::Rest::Error => e
2354
+ raise ::Google::Cloud::Error.from_error(e)
2355
+ end
2356
+
2357
+ ##
2358
+ # Deletes a single BackupPlan.
2359
+ #
2360
+ # @overload delete_backup_plan(request, options = nil)
2361
+ # Pass arguments to `delete_backup_plan` via a request object, either of type
2362
+ # {::Google::Cloud::BackupDR::V1::DeleteBackupPlanRequest} or an equivalent Hash.
2363
+ #
2364
+ # @param request [::Google::Cloud::BackupDR::V1::DeleteBackupPlanRequest, ::Hash]
2365
+ # A request object representing the call parameters. Required. To specify no
2366
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2367
+ # @param options [::Gapic::CallOptions, ::Hash]
2368
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2369
+ #
2370
+ # @overload delete_backup_plan(name: nil, request_id: nil)
2371
+ # Pass arguments to `delete_backup_plan` via keyword arguments. Note that at
2372
+ # least one keyword argument is required. To specify no parameters, or to keep all
2373
+ # the default parameter values, pass an empty Hash as a request object (see above).
2374
+ #
2375
+ # @param name [::String]
2376
+ # Required. The resource name of the `BackupPlan` to delete.
2377
+ #
2378
+ # Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}`
2379
+ # @param request_id [::String]
2380
+ # Optional. An optional request ID to identify requests. Specify a unique
2381
+ # request ID so that if you must retry your request, the server will know to
2382
+ # ignore the request if it has already been completed. The server will
2383
+ # guarantee that for at least 60 minutes after the first request.
2384
+ #
2385
+ # For example, consider a situation where you make an initial request and
2386
+ # the request times out. If you make the request again with the same request
2387
+ # ID, the server can check if original operation with the same request ID
2388
+ # was received, and if so, will ignore the second request. This prevents
2389
+ # clients from accidentally creating duplicate commitments.
2390
+ #
2391
+ # The request ID must be a valid UUID with the exception that zero UUID is
2392
+ # not supported (00000000-0000-0000-0000-000000000000).
2393
+ # @yield [result, operation] Access the result along with the TransportOperation object
2394
+ # @yieldparam result [::Gapic::Operation]
2395
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2396
+ #
2397
+ # @return [::Gapic::Operation]
2398
+ #
2399
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2400
+ #
2401
+ # @example Basic example
2402
+ # require "google/cloud/backupdr/v1"
2403
+ #
2404
+ # # Create a client object. The client can be reused for multiple calls.
2405
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2406
+ #
2407
+ # # Create a request. To set request fields, pass in keyword arguments.
2408
+ # request = Google::Cloud::BackupDR::V1::DeleteBackupPlanRequest.new
2409
+ #
2410
+ # # Call the delete_backup_plan method.
2411
+ # result = client.delete_backup_plan request
2412
+ #
2413
+ # # The returned object is of type Gapic::Operation. You can use it to
2414
+ # # check the status of an operation, cancel it, or wait for results.
2415
+ # # Here is how to wait for a response.
2416
+ # result.wait_until_done! timeout: 60
2417
+ # if result.response?
2418
+ # p result.response
2419
+ # else
2420
+ # puts "No response received."
2421
+ # end
2422
+ #
2423
+ def delete_backup_plan request, options = nil
2424
+ raise ::ArgumentError, "request must be provided" if request.nil?
2425
+
2426
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::DeleteBackupPlanRequest
2427
+
2428
+ # Converts hash and nil to an options object
2429
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2430
+
2431
+ # Customize the options with defaults
2432
+ call_metadata = @config.rpcs.delete_backup_plan.metadata.to_h
2433
+
2434
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2435
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2436
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2437
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2438
+ transports_version_send: [:rest]
2439
+
2440
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2441
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2442
+
2443
+ options.apply_defaults timeout: @config.rpcs.delete_backup_plan.timeout,
2444
+ metadata: call_metadata,
2445
+ retry_policy: @config.rpcs.delete_backup_plan.retry_policy
2446
+
2447
+ options.apply_defaults timeout: @config.timeout,
2448
+ metadata: @config.metadata,
2449
+ retry_policy: @config.retry_policy
2450
+
2451
+ @backup_dr_stub.delete_backup_plan request, options do |result, operation|
2452
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2453
+ yield result, operation if block_given?
2454
+ return result
2455
+ end
2456
+ rescue ::Gapic::Rest::Error => e
2457
+ raise ::Google::Cloud::Error.from_error(e)
2458
+ end
2459
+
2460
+ ##
2461
+ # Create a BackupPlanAssociation
2462
+ #
2463
+ # @overload create_backup_plan_association(request, options = nil)
2464
+ # Pass arguments to `create_backup_plan_association` via a request object, either of type
2465
+ # {::Google::Cloud::BackupDR::V1::CreateBackupPlanAssociationRequest} or an equivalent Hash.
2466
+ #
2467
+ # @param request [::Google::Cloud::BackupDR::V1::CreateBackupPlanAssociationRequest, ::Hash]
2468
+ # A request object representing the call parameters. Required. To specify no
2469
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2470
+ # @param options [::Gapic::CallOptions, ::Hash]
2471
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2472
+ #
2473
+ # @overload create_backup_plan_association(parent: nil, backup_plan_association_id: nil, backup_plan_association: nil, request_id: nil)
2474
+ # Pass arguments to `create_backup_plan_association` via keyword arguments. Note that at
2475
+ # least one keyword argument is required. To specify no parameters, or to keep all
2476
+ # the default parameter values, pass an empty Hash as a request object (see above).
2477
+ #
2478
+ # @param parent [::String]
2479
+ # Required. The backup plan association project and location in the format
2480
+ # `projects/{project_id}/locations/{location}`. In Cloud BackupDR locations
2481
+ # map to GCP regions, for example **us-central1**.
2482
+ # @param backup_plan_association_id [::String]
2483
+ # Required. The name of the backup plan association to create. The name must
2484
+ # be unique for the specified project and location.
2485
+ # @param backup_plan_association [::Google::Cloud::BackupDR::V1::BackupPlanAssociation, ::Hash]
2486
+ # Required. The resource being created
2487
+ # @param request_id [::String]
2488
+ # Optional. An optional request ID to identify requests. Specify a unique
2489
+ # request ID so that if you must retry your request, the server will know to
2490
+ # ignore the request if it has already been completed. The server will
2491
+ # guarantee that for at least 60 minutes since the first request.
2492
+ #
2493
+ # For example, consider a situation where you make an initial request and t
2494
+ # he request times out. If you make the request again with the same request
2495
+ # ID, the server can check if original operation with the same request ID
2496
+ # was received, and if so, will ignore the second request. This prevents
2497
+ # clients from accidentally creating duplicate commitments.
2498
+ #
2499
+ # The request ID must be a valid UUID with the exception that zero UUID is
2500
+ # not supported (00000000-0000-0000-0000-000000000000).
2501
+ # @yield [result, operation] Access the result along with the TransportOperation object
2502
+ # @yieldparam result [::Gapic::Operation]
2503
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2504
+ #
2505
+ # @return [::Gapic::Operation]
2506
+ #
2507
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2508
+ #
2509
+ # @example Basic example
2510
+ # require "google/cloud/backupdr/v1"
2511
+ #
2512
+ # # Create a client object. The client can be reused for multiple calls.
2513
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2514
+ #
2515
+ # # Create a request. To set request fields, pass in keyword arguments.
2516
+ # request = Google::Cloud::BackupDR::V1::CreateBackupPlanAssociationRequest.new
2517
+ #
2518
+ # # Call the create_backup_plan_association method.
2519
+ # result = client.create_backup_plan_association request
2520
+ #
2521
+ # # The returned object is of type Gapic::Operation. You can use it to
2522
+ # # check the status of an operation, cancel it, or wait for results.
2523
+ # # Here is how to wait for a response.
2524
+ # result.wait_until_done! timeout: 60
2525
+ # if result.response?
2526
+ # p result.response
2527
+ # else
2528
+ # puts "No response received."
2529
+ # end
2530
+ #
2531
+ def create_backup_plan_association request, options = nil
2532
+ raise ::ArgumentError, "request must be provided" if request.nil?
2533
+
2534
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::CreateBackupPlanAssociationRequest
2535
+
2536
+ # Converts hash and nil to an options object
2537
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2538
+
2539
+ # Customize the options with defaults
2540
+ call_metadata = @config.rpcs.create_backup_plan_association.metadata.to_h
2541
+
2542
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2543
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2544
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2545
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2546
+ transports_version_send: [:rest]
2547
+
2548
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2549
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2550
+
2551
+ options.apply_defaults timeout: @config.rpcs.create_backup_plan_association.timeout,
2552
+ metadata: call_metadata,
2553
+ retry_policy: @config.rpcs.create_backup_plan_association.retry_policy
2554
+
2555
+ options.apply_defaults timeout: @config.timeout,
2556
+ metadata: @config.metadata,
2557
+ retry_policy: @config.retry_policy
2558
+
2559
+ @backup_dr_stub.create_backup_plan_association request, options do |result, operation|
2560
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2561
+ yield result, operation if block_given?
2562
+ return result
2563
+ end
2564
+ rescue ::Gapic::Rest::Error => e
2565
+ raise ::Google::Cloud::Error.from_error(e)
2566
+ end
2567
+
2568
+ ##
2569
+ # Gets details of a single BackupPlanAssociation.
2570
+ #
2571
+ # @overload get_backup_plan_association(request, options = nil)
2572
+ # Pass arguments to `get_backup_plan_association` via a request object, either of type
2573
+ # {::Google::Cloud::BackupDR::V1::GetBackupPlanAssociationRequest} or an equivalent Hash.
2574
+ #
2575
+ # @param request [::Google::Cloud::BackupDR::V1::GetBackupPlanAssociationRequest, ::Hash]
2576
+ # A request object representing the call parameters. Required. To specify no
2577
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2578
+ # @param options [::Gapic::CallOptions, ::Hash]
2579
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2580
+ #
2581
+ # @overload get_backup_plan_association(name: nil)
2582
+ # Pass arguments to `get_backup_plan_association` via keyword arguments. Note that at
2583
+ # least one keyword argument is required. To specify no parameters, or to keep all
2584
+ # the default parameter values, pass an empty Hash as a request object (see above).
2585
+ #
2586
+ # @param name [::String]
2587
+ # Required. Name of the backup plan association resource, in the format
2588
+ # `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`
2589
+ # @yield [result, operation] Access the result along with the TransportOperation object
2590
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::BackupPlanAssociation]
2591
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2592
+ #
2593
+ # @return [::Google::Cloud::BackupDR::V1::BackupPlanAssociation]
2594
+ #
2595
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2596
+ #
2597
+ # @example Basic example
2598
+ # require "google/cloud/backupdr/v1"
2599
+ #
2600
+ # # Create a client object. The client can be reused for multiple calls.
2601
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2602
+ #
2603
+ # # Create a request. To set request fields, pass in keyword arguments.
2604
+ # request = Google::Cloud::BackupDR::V1::GetBackupPlanAssociationRequest.new
2605
+ #
2606
+ # # Call the get_backup_plan_association method.
2607
+ # result = client.get_backup_plan_association request
2608
+ #
2609
+ # # The returned object is of type Google::Cloud::BackupDR::V1::BackupPlanAssociation.
2610
+ # p result
2611
+ #
2612
+ def get_backup_plan_association request, options = nil
2613
+ raise ::ArgumentError, "request must be provided" if request.nil?
2614
+
2615
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::GetBackupPlanAssociationRequest
2616
+
2617
+ # Converts hash and nil to an options object
2618
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2619
+
2620
+ # Customize the options with defaults
2621
+ call_metadata = @config.rpcs.get_backup_plan_association.metadata.to_h
2622
+
2623
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2624
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2625
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2626
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2627
+ transports_version_send: [:rest]
2628
+
2629
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2630
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2631
+
2632
+ options.apply_defaults timeout: @config.rpcs.get_backup_plan_association.timeout,
2633
+ metadata: call_metadata,
2634
+ retry_policy: @config.rpcs.get_backup_plan_association.retry_policy
2635
+
2636
+ options.apply_defaults timeout: @config.timeout,
2637
+ metadata: @config.metadata,
2638
+ retry_policy: @config.retry_policy
2639
+
2640
+ @backup_dr_stub.get_backup_plan_association request, options do |result, operation|
2641
+ yield result, operation if block_given?
2642
+ return result
2643
+ end
2644
+ rescue ::Gapic::Rest::Error => e
2645
+ raise ::Google::Cloud::Error.from_error(e)
2646
+ end
2647
+
2648
+ ##
2649
+ # Lists BackupPlanAssociations in a given project and location.
2650
+ #
2651
+ # @overload list_backup_plan_associations(request, options = nil)
2652
+ # Pass arguments to `list_backup_plan_associations` via a request object, either of type
2653
+ # {::Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsRequest} or an equivalent Hash.
2654
+ #
2655
+ # @param request [::Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsRequest, ::Hash]
2656
+ # A request object representing the call parameters. Required. To specify no
2657
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2658
+ # @param options [::Gapic::CallOptions, ::Hash]
2659
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2660
+ #
2661
+ # @overload list_backup_plan_associations(parent: nil, page_size: nil, page_token: nil, filter: nil)
2662
+ # Pass arguments to `list_backup_plan_associations` via keyword arguments. Note that at
2663
+ # least one keyword argument is required. To specify no parameters, or to keep all
2664
+ # the default parameter values, pass an empty Hash as a request object (see above).
2665
+ #
2666
+ # @param parent [::String]
2667
+ # Required. The project and location for which to retrieve backup Plan
2668
+ # Associations information, in the format
2669
+ # `projects/{project_id}/locations/{location}`. In Cloud BackupDR, locations
2670
+ # map to GCP regions, for example **us-central1**. To retrieve backup plan
2671
+ # associations for all locations, use "-" for the
2672
+ # `{location}` value.
2673
+ # @param page_size [::Integer]
2674
+ # Optional. Requested page size. Server may return fewer items than
2675
+ # requested. If unspecified, server will pick an appropriate default.
2676
+ # @param page_token [::String]
2677
+ # Optional. A token identifying a page of results the server should return.
2678
+ # @param filter [::String]
2679
+ # Optional. Filtering results
2680
+ # @yield [result, operation] Access the result along with the TransportOperation object
2681
+ # @yieldparam result [::Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsResponse]
2682
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2683
+ #
2684
+ # @return [::Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsResponse]
2685
+ #
2686
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2687
+ #
2688
+ # @example Basic example
2689
+ # require "google/cloud/backupdr/v1"
2690
+ #
2691
+ # # Create a client object. The client can be reused for multiple calls.
2692
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2693
+ #
2694
+ # # Create a request. To set request fields, pass in keyword arguments.
2695
+ # request = Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsRequest.new
2696
+ #
2697
+ # # Call the list_backup_plan_associations method.
2698
+ # result = client.list_backup_plan_associations request
2699
+ #
2700
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2701
+ # # over elements, and API calls will be issued to fetch pages as needed.
2702
+ # result.each do |item|
2703
+ # # Each element is of type ::Google::Cloud::BackupDR::V1::BackupPlanAssociation.
2704
+ # p item
2705
+ # end
2706
+ #
2707
+ def list_backup_plan_associations request, options = nil
2708
+ raise ::ArgumentError, "request must be provided" if request.nil?
2709
+
2710
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::ListBackupPlanAssociationsRequest
2711
+
2712
+ # Converts hash and nil to an options object
2713
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2714
+
2715
+ # Customize the options with defaults
2716
+ call_metadata = @config.rpcs.list_backup_plan_associations.metadata.to_h
2717
+
2718
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2719
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2720
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2721
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2722
+ transports_version_send: [:rest]
2723
+
2724
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2725
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2726
+
2727
+ options.apply_defaults timeout: @config.rpcs.list_backup_plan_associations.timeout,
2728
+ metadata: call_metadata,
2729
+ retry_policy: @config.rpcs.list_backup_plan_associations.retry_policy
2730
+
2731
+ options.apply_defaults timeout: @config.timeout,
2732
+ metadata: @config.metadata,
2733
+ retry_policy: @config.retry_policy
2734
+
2735
+ @backup_dr_stub.list_backup_plan_associations request, options do |result, operation|
2736
+ yield result, operation if block_given?
2737
+ return result
2738
+ end
2739
+ rescue ::Gapic::Rest::Error => e
2740
+ raise ::Google::Cloud::Error.from_error(e)
2741
+ end
2742
+
2743
+ ##
2744
+ # Deletes a single BackupPlanAssociation.
2745
+ #
2746
+ # @overload delete_backup_plan_association(request, options = nil)
2747
+ # Pass arguments to `delete_backup_plan_association` via a request object, either of type
2748
+ # {::Google::Cloud::BackupDR::V1::DeleteBackupPlanAssociationRequest} or an equivalent Hash.
2749
+ #
2750
+ # @param request [::Google::Cloud::BackupDR::V1::DeleteBackupPlanAssociationRequest, ::Hash]
2751
+ # A request object representing the call parameters. Required. To specify no
2752
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2753
+ # @param options [::Gapic::CallOptions, ::Hash]
2754
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2755
+ #
2756
+ # @overload delete_backup_plan_association(name: nil, request_id: nil)
2757
+ # Pass arguments to `delete_backup_plan_association` via keyword arguments. Note that at
2758
+ # least one keyword argument is required. To specify no parameters, or to keep all
2759
+ # the default parameter values, pass an empty Hash as a request object (see above).
2760
+ #
2761
+ # @param name [::String]
2762
+ # Required. Name of the backup plan association resource, in the format
2763
+ # `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`
2764
+ # @param request_id [::String]
2765
+ # Optional. An optional request ID to identify requests. Specify a unique
2766
+ # request ID so that if you must retry your request, the server will know to
2767
+ # ignore the request if it has already been completed. The server will
2768
+ # guarantee that for at least 60 minutes after the first request.
2769
+ #
2770
+ # For example, consider a situation where you make an initial request and
2771
+ # the request times out. If you make the request again with the same request
2772
+ # ID, the server can check if original operation with the same request ID
2773
+ # was received, and if so, will ignore the second request. This prevents
2774
+ # clients from accidentally creating duplicate commitments.
2775
+ #
2776
+ # The request ID must be a valid UUID with the exception that zero UUID is
2777
+ # not supported (00000000-0000-0000-0000-000000000000).
2778
+ # @yield [result, operation] Access the result along with the TransportOperation object
2779
+ # @yieldparam result [::Gapic::Operation]
2780
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2781
+ #
2782
+ # @return [::Gapic::Operation]
2783
+ #
2784
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2785
+ #
2786
+ # @example Basic example
2787
+ # require "google/cloud/backupdr/v1"
2788
+ #
2789
+ # # Create a client object. The client can be reused for multiple calls.
2790
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2791
+ #
2792
+ # # Create a request. To set request fields, pass in keyword arguments.
2793
+ # request = Google::Cloud::BackupDR::V1::DeleteBackupPlanAssociationRequest.new
2794
+ #
2795
+ # # Call the delete_backup_plan_association method.
2796
+ # result = client.delete_backup_plan_association request
2797
+ #
2798
+ # # The returned object is of type Gapic::Operation. You can use it to
2799
+ # # check the status of an operation, cancel it, or wait for results.
2800
+ # # Here is how to wait for a response.
2801
+ # result.wait_until_done! timeout: 60
2802
+ # if result.response?
2803
+ # p result.response
2804
+ # else
2805
+ # puts "No response received."
2806
+ # end
2807
+ #
2808
+ def delete_backup_plan_association request, options = nil
2809
+ raise ::ArgumentError, "request must be provided" if request.nil?
2810
+
2811
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::DeleteBackupPlanAssociationRequest
2812
+
2813
+ # Converts hash and nil to an options object
2814
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2815
+
2816
+ # Customize the options with defaults
2817
+ call_metadata = @config.rpcs.delete_backup_plan_association.metadata.to_h
2818
+
2819
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2820
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2821
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2822
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2823
+ transports_version_send: [:rest]
2824
+
2825
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2826
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2827
+
2828
+ options.apply_defaults timeout: @config.rpcs.delete_backup_plan_association.timeout,
2829
+ metadata: call_metadata,
2830
+ retry_policy: @config.rpcs.delete_backup_plan_association.retry_policy
2831
+
2832
+ options.apply_defaults timeout: @config.timeout,
2833
+ metadata: @config.metadata,
2834
+ retry_policy: @config.retry_policy
2835
+
2836
+ @backup_dr_stub.delete_backup_plan_association request, options do |result, operation|
2837
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2838
+ yield result, operation if block_given?
2839
+ return result
2840
+ end
2841
+ rescue ::Gapic::Rest::Error => e
2842
+ raise ::Google::Cloud::Error.from_error(e)
2843
+ end
2844
+
2845
+ ##
2846
+ # Triggers a new Backup.
2847
+ #
2848
+ # @overload trigger_backup(request, options = nil)
2849
+ # Pass arguments to `trigger_backup` via a request object, either of type
2850
+ # {::Google::Cloud::BackupDR::V1::TriggerBackupRequest} or an equivalent Hash.
2851
+ #
2852
+ # @param request [::Google::Cloud::BackupDR::V1::TriggerBackupRequest, ::Hash]
2853
+ # A request object representing the call parameters. Required. To specify no
2854
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2855
+ # @param options [::Gapic::CallOptions, ::Hash]
2856
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2857
+ #
2858
+ # @overload trigger_backup(name: nil, rule_id: nil, request_id: nil)
2859
+ # Pass arguments to `trigger_backup` via keyword arguments. Note that at
2860
+ # least one keyword argument is required. To specify no parameters, or to keep all
2861
+ # the default parameter values, pass an empty Hash as a request object (see above).
2862
+ #
2863
+ # @param name [::String]
2864
+ # Required. Name of the backup plan association resource, in the format
2865
+ # `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`
2866
+ # @param rule_id [::String]
2867
+ # Required. backup rule_id for which a backup needs to be triggered.
2868
+ # @param request_id [::String]
2869
+ # Optional. An optional request ID to identify requests. Specify a unique
2870
+ # request ID so that if you must retry your request, the server will know to
2871
+ # ignore the request if it has already been completed. The server will
2872
+ # guarantee that for at least 60 minutes after the first request.
2873
+ #
2874
+ # For example, consider a situation where you make an initial request and
2875
+ # the request times out. If you make the request again with the same request
2876
+ # ID, the server can check if original operation with the same request ID
2877
+ # was received, and if so, will ignore the second request. This prevents
2878
+ # clients from accidentally creating duplicate commitments.
2879
+ #
2880
+ # The request ID must be a valid UUID with the exception that zero UUID is
2881
+ # not supported (00000000-0000-0000-0000-000000000000).
2882
+ # @yield [result, operation] Access the result along with the TransportOperation object
2883
+ # @yieldparam result [::Gapic::Operation]
2884
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2885
+ #
2886
+ # @return [::Gapic::Operation]
2887
+ #
2888
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2889
+ #
2890
+ # @example Basic example
2891
+ # require "google/cloud/backupdr/v1"
2892
+ #
2893
+ # # Create a client object. The client can be reused for multiple calls.
2894
+ # client = Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new
2895
+ #
2896
+ # # Create a request. To set request fields, pass in keyword arguments.
2897
+ # request = Google::Cloud::BackupDR::V1::TriggerBackupRequest.new
2898
+ #
2899
+ # # Call the trigger_backup method.
2900
+ # result = client.trigger_backup request
2901
+ #
2902
+ # # The returned object is of type Gapic::Operation. You can use it to
2903
+ # # check the status of an operation, cancel it, or wait for results.
2904
+ # # Here is how to wait for a response.
2905
+ # result.wait_until_done! timeout: 60
2906
+ # if result.response?
2907
+ # p result.response
2908
+ # else
2909
+ # puts "No response received."
2910
+ # end
2911
+ #
2912
+ def trigger_backup request, options = nil
2913
+ raise ::ArgumentError, "request must be provided" if request.nil?
2914
+
2915
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::BackupDR::V1::TriggerBackupRequest
2916
+
2917
+ # Converts hash and nil to an options object
2918
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2919
+
2920
+ # Customize the options with defaults
2921
+ call_metadata = @config.rpcs.trigger_backup.metadata.to_h
2922
+
2923
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2924
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2925
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2926
+ gapic_version: ::Google::Cloud::BackupDR::V1::VERSION,
2927
+ transports_version_send: [:rest]
2928
+
2929
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2930
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2931
+
2932
+ options.apply_defaults timeout: @config.rpcs.trigger_backup.timeout,
2933
+ metadata: call_metadata,
2934
+ retry_policy: @config.rpcs.trigger_backup.retry_policy
2935
+
2936
+ options.apply_defaults timeout: @config.timeout,
2937
+ metadata: @config.metadata,
2938
+ retry_policy: @config.retry_policy
2939
+
2940
+ @backup_dr_stub.trigger_backup request, options do |result, operation|
2941
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2942
+ yield result, operation if block_given?
2943
+ return result
2944
+ end
2945
+ rescue ::Gapic::Rest::Error => e
2946
+ raise ::Google::Cloud::Error.from_error(e)
2947
+ end
2948
+
2949
+ ##
2950
+ # Configuration class for the BackupDR REST API.
2951
+ #
2952
+ # This class represents the configuration for BackupDR REST,
2953
+ # providing control over timeouts, retry behavior, logging, transport
2954
+ # parameters, and other low-level controls. Certain parameters can also be
2955
+ # applied individually to specific RPCs. See
2956
+ # {::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client::Configuration::Rpcs}
2957
+ # for a list of RPCs that can be configured independently.
2958
+ #
2959
+ # Configuration can be applied globally to all clients, or to a single client
2960
+ # on construction.
2961
+ #
2962
+ # @example
2963
+ #
2964
+ # # Modify the global config, setting the timeout for
2965
+ # # list_management_servers to 20 seconds,
2966
+ # # and all remaining timeouts to 10 seconds.
2967
+ # ::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.configure do |config|
2968
+ # config.timeout = 10.0
2969
+ # config.rpcs.list_management_servers.timeout = 20.0
2970
+ # end
2971
+ #
2972
+ # # Apply the above configuration only to a new client.
2973
+ # client = ::Google::Cloud::BackupDR::V1::BackupDR::Rest::Client.new do |config|
2974
+ # config.timeout = 10.0
2975
+ # config.rpcs.list_management_servers.timeout = 20.0
2976
+ # end
2977
+ #
2978
+ # @!attribute [rw] endpoint
2979
+ # A custom service endpoint, as a hostname or hostname:port. The default is
2980
+ # nil, indicating to use the default endpoint in the current universe domain.
2981
+ # @return [::String,nil]
2982
+ # @!attribute [rw] credentials
2983
+ # Credentials to send with calls. You may provide any of the following types:
2984
+ # * (`String`) The path to a service account key file in JSON format
2985
+ # * (`Hash`) A service account key as a Hash
2986
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
2987
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2988
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2989
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2990
+ # * (`nil`) indicating no credentials
2991
+ # @return [::Object]
2992
+ # @!attribute [rw] scope
2993
+ # The OAuth scopes
2994
+ # @return [::Array<::String>]
2995
+ # @!attribute [rw] lib_name
2996
+ # The library name as recorded in instrumentation and logging
2997
+ # @return [::String]
2998
+ # @!attribute [rw] lib_version
2999
+ # The library version as recorded in instrumentation and logging
3000
+ # @return [::String]
3001
+ # @!attribute [rw] timeout
3002
+ # The call timeout in seconds.
3003
+ # @return [::Numeric]
3004
+ # @!attribute [rw] metadata
3005
+ # Additional headers to be sent with the call.
3006
+ # @return [::Hash{::Symbol=>::String}]
3007
+ # @!attribute [rw] retry_policy
3008
+ # The retry policy. The value is a hash with the following keys:
3009
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3010
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3011
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3012
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3013
+ # trigger a retry.
3014
+ # @return [::Hash]
3015
+ # @!attribute [rw] quota_project
3016
+ # A separate project against which to charge quota.
3017
+ # @return [::String]
3018
+ # @!attribute [rw] universe_domain
3019
+ # The universe domain within which to make requests. This determines the
3020
+ # default endpoint URL. The default value of nil uses the environment
3021
+ # universe (usually the default "googleapis.com" universe).
3022
+ # @return [::String,nil]
3023
+ #
3024
+ class Configuration
3025
+ extend ::Gapic::Config
3026
+
3027
+ # @private
3028
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
3029
+ DEFAULT_ENDPOINT = "backupdr.googleapis.com"
3030
+
3031
+ config_attr :endpoint, nil, ::String, nil
3032
+ config_attr :credentials, nil do |value|
3033
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
3034
+ allowed.any? { |klass| klass === value }
3035
+ end
3036
+ config_attr :scope, nil, ::String, ::Array, nil
3037
+ config_attr :lib_name, nil, ::String, nil
3038
+ config_attr :lib_version, nil, ::String, nil
3039
+ config_attr :timeout, nil, ::Numeric, nil
3040
+ config_attr :metadata, nil, ::Hash, nil
3041
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3042
+ config_attr :quota_project, nil, ::String, nil
3043
+ config_attr :universe_domain, nil, ::String, nil
3044
+
3045
+ # @private
3046
+ # Overrides for http bindings for the RPCs of this service
3047
+ # are only used when this service is used as mixin, and only
3048
+ # by the host service.
3049
+ # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
3050
+ config_attr :bindings_override, {}, ::Hash, nil
3051
+
3052
+ # @private
3053
+ def initialize parent_config = nil
3054
+ @parent_config = parent_config unless parent_config.nil?
3055
+
3056
+ yield self if block_given?
3057
+ end
3058
+
3059
+ ##
3060
+ # Configurations for individual RPCs
3061
+ # @return [Rpcs]
3062
+ #
3063
+ def rpcs
3064
+ @rpcs ||= begin
3065
+ parent_rpcs = nil
3066
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
3067
+ Rpcs.new parent_rpcs
3068
+ end
3069
+ end
3070
+
3071
+ ##
3072
+ # Configuration RPC class for the BackupDR API.
3073
+ #
3074
+ # Includes fields providing the configuration for each RPC in this service.
3075
+ # Each configuration object is of type `Gapic::Config::Method` and includes
3076
+ # the following configuration fields:
3077
+ #
3078
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
3079
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
3080
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
3081
+ # include the following keys:
3082
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3083
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3084
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3085
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3086
+ # trigger a retry.
3087
+ #
3088
+ class Rpcs
3089
+ ##
3090
+ # RPC-specific configuration for `list_management_servers`
3091
+ # @return [::Gapic::Config::Method]
3092
+ #
3093
+ attr_reader :list_management_servers
3094
+ ##
3095
+ # RPC-specific configuration for `get_management_server`
3096
+ # @return [::Gapic::Config::Method]
3097
+ #
3098
+ attr_reader :get_management_server
3099
+ ##
3100
+ # RPC-specific configuration for `create_management_server`
3101
+ # @return [::Gapic::Config::Method]
3102
+ #
3103
+ attr_reader :create_management_server
3104
+ ##
3105
+ # RPC-specific configuration for `delete_management_server`
3106
+ # @return [::Gapic::Config::Method]
3107
+ #
3108
+ attr_reader :delete_management_server
3109
+ ##
3110
+ # RPC-specific configuration for `create_backup_vault`
3111
+ # @return [::Gapic::Config::Method]
3112
+ #
3113
+ attr_reader :create_backup_vault
3114
+ ##
3115
+ # RPC-specific configuration for `list_backup_vaults`
3116
+ # @return [::Gapic::Config::Method]
3117
+ #
3118
+ attr_reader :list_backup_vaults
3119
+ ##
3120
+ # RPC-specific configuration for `fetch_usable_backup_vaults`
3121
+ # @return [::Gapic::Config::Method]
3122
+ #
3123
+ attr_reader :fetch_usable_backup_vaults
3124
+ ##
3125
+ # RPC-specific configuration for `get_backup_vault`
3126
+ # @return [::Gapic::Config::Method]
3127
+ #
3128
+ attr_reader :get_backup_vault
3129
+ ##
3130
+ # RPC-specific configuration for `update_backup_vault`
3131
+ # @return [::Gapic::Config::Method]
3132
+ #
3133
+ attr_reader :update_backup_vault
3134
+ ##
3135
+ # RPC-specific configuration for `delete_backup_vault`
3136
+ # @return [::Gapic::Config::Method]
3137
+ #
3138
+ attr_reader :delete_backup_vault
3139
+ ##
3140
+ # RPC-specific configuration for `list_data_sources`
3141
+ # @return [::Gapic::Config::Method]
3142
+ #
3143
+ attr_reader :list_data_sources
3144
+ ##
3145
+ # RPC-specific configuration for `get_data_source`
3146
+ # @return [::Gapic::Config::Method]
3147
+ #
3148
+ attr_reader :get_data_source
3149
+ ##
3150
+ # RPC-specific configuration for `update_data_source`
3151
+ # @return [::Gapic::Config::Method]
3152
+ #
3153
+ attr_reader :update_data_source
3154
+ ##
3155
+ # RPC-specific configuration for `list_backups`
3156
+ # @return [::Gapic::Config::Method]
3157
+ #
3158
+ attr_reader :list_backups
3159
+ ##
3160
+ # RPC-specific configuration for `get_backup`
3161
+ # @return [::Gapic::Config::Method]
3162
+ #
3163
+ attr_reader :get_backup
3164
+ ##
3165
+ # RPC-specific configuration for `update_backup`
3166
+ # @return [::Gapic::Config::Method]
3167
+ #
3168
+ attr_reader :update_backup
3169
+ ##
3170
+ # RPC-specific configuration for `delete_backup`
3171
+ # @return [::Gapic::Config::Method]
3172
+ #
3173
+ attr_reader :delete_backup
3174
+ ##
3175
+ # RPC-specific configuration for `restore_backup`
3176
+ # @return [::Gapic::Config::Method]
3177
+ #
3178
+ attr_reader :restore_backup
3179
+ ##
3180
+ # RPC-specific configuration for `create_backup_plan`
3181
+ # @return [::Gapic::Config::Method]
3182
+ #
3183
+ attr_reader :create_backup_plan
3184
+ ##
3185
+ # RPC-specific configuration for `get_backup_plan`
3186
+ # @return [::Gapic::Config::Method]
3187
+ #
3188
+ attr_reader :get_backup_plan
3189
+ ##
3190
+ # RPC-specific configuration for `list_backup_plans`
3191
+ # @return [::Gapic::Config::Method]
3192
+ #
3193
+ attr_reader :list_backup_plans
3194
+ ##
3195
+ # RPC-specific configuration for `delete_backup_plan`
3196
+ # @return [::Gapic::Config::Method]
3197
+ #
3198
+ attr_reader :delete_backup_plan
3199
+ ##
3200
+ # RPC-specific configuration for `create_backup_plan_association`
3201
+ # @return [::Gapic::Config::Method]
3202
+ #
3203
+ attr_reader :create_backup_plan_association
3204
+ ##
3205
+ # RPC-specific configuration for `get_backup_plan_association`
3206
+ # @return [::Gapic::Config::Method]
3207
+ #
3208
+ attr_reader :get_backup_plan_association
3209
+ ##
3210
+ # RPC-specific configuration for `list_backup_plan_associations`
3211
+ # @return [::Gapic::Config::Method]
3212
+ #
3213
+ attr_reader :list_backup_plan_associations
3214
+ ##
3215
+ # RPC-specific configuration for `delete_backup_plan_association`
3216
+ # @return [::Gapic::Config::Method]
3217
+ #
3218
+ attr_reader :delete_backup_plan_association
3219
+ ##
3220
+ # RPC-specific configuration for `trigger_backup`
3221
+ # @return [::Gapic::Config::Method]
3222
+ #
3223
+ attr_reader :trigger_backup
765
3224
 
766
3225
  # @private
767
3226
  def initialize parent_rpcs = nil
@@ -773,6 +3232,52 @@ module Google
773
3232
  @create_management_server = ::Gapic::Config::Method.new create_management_server_config
774
3233
  delete_management_server_config = parent_rpcs.delete_management_server if parent_rpcs.respond_to? :delete_management_server
775
3234
  @delete_management_server = ::Gapic::Config::Method.new delete_management_server_config
3235
+ create_backup_vault_config = parent_rpcs.create_backup_vault if parent_rpcs.respond_to? :create_backup_vault
3236
+ @create_backup_vault = ::Gapic::Config::Method.new create_backup_vault_config
3237
+ list_backup_vaults_config = parent_rpcs.list_backup_vaults if parent_rpcs.respond_to? :list_backup_vaults
3238
+ @list_backup_vaults = ::Gapic::Config::Method.new list_backup_vaults_config
3239
+ fetch_usable_backup_vaults_config = parent_rpcs.fetch_usable_backup_vaults if parent_rpcs.respond_to? :fetch_usable_backup_vaults
3240
+ @fetch_usable_backup_vaults = ::Gapic::Config::Method.new fetch_usable_backup_vaults_config
3241
+ get_backup_vault_config = parent_rpcs.get_backup_vault if parent_rpcs.respond_to? :get_backup_vault
3242
+ @get_backup_vault = ::Gapic::Config::Method.new get_backup_vault_config
3243
+ update_backup_vault_config = parent_rpcs.update_backup_vault if parent_rpcs.respond_to? :update_backup_vault
3244
+ @update_backup_vault = ::Gapic::Config::Method.new update_backup_vault_config
3245
+ delete_backup_vault_config = parent_rpcs.delete_backup_vault if parent_rpcs.respond_to? :delete_backup_vault
3246
+ @delete_backup_vault = ::Gapic::Config::Method.new delete_backup_vault_config
3247
+ list_data_sources_config = parent_rpcs.list_data_sources if parent_rpcs.respond_to? :list_data_sources
3248
+ @list_data_sources = ::Gapic::Config::Method.new list_data_sources_config
3249
+ get_data_source_config = parent_rpcs.get_data_source if parent_rpcs.respond_to? :get_data_source
3250
+ @get_data_source = ::Gapic::Config::Method.new get_data_source_config
3251
+ update_data_source_config = parent_rpcs.update_data_source if parent_rpcs.respond_to? :update_data_source
3252
+ @update_data_source = ::Gapic::Config::Method.new update_data_source_config
3253
+ list_backups_config = parent_rpcs.list_backups if parent_rpcs.respond_to? :list_backups
3254
+ @list_backups = ::Gapic::Config::Method.new list_backups_config
3255
+ get_backup_config = parent_rpcs.get_backup if parent_rpcs.respond_to? :get_backup
3256
+ @get_backup = ::Gapic::Config::Method.new get_backup_config
3257
+ update_backup_config = parent_rpcs.update_backup if parent_rpcs.respond_to? :update_backup
3258
+ @update_backup = ::Gapic::Config::Method.new update_backup_config
3259
+ delete_backup_config = parent_rpcs.delete_backup if parent_rpcs.respond_to? :delete_backup
3260
+ @delete_backup = ::Gapic::Config::Method.new delete_backup_config
3261
+ restore_backup_config = parent_rpcs.restore_backup if parent_rpcs.respond_to? :restore_backup
3262
+ @restore_backup = ::Gapic::Config::Method.new restore_backup_config
3263
+ create_backup_plan_config = parent_rpcs.create_backup_plan if parent_rpcs.respond_to? :create_backup_plan
3264
+ @create_backup_plan = ::Gapic::Config::Method.new create_backup_plan_config
3265
+ get_backup_plan_config = parent_rpcs.get_backup_plan if parent_rpcs.respond_to? :get_backup_plan
3266
+ @get_backup_plan = ::Gapic::Config::Method.new get_backup_plan_config
3267
+ list_backup_plans_config = parent_rpcs.list_backup_plans if parent_rpcs.respond_to? :list_backup_plans
3268
+ @list_backup_plans = ::Gapic::Config::Method.new list_backup_plans_config
3269
+ delete_backup_plan_config = parent_rpcs.delete_backup_plan if parent_rpcs.respond_to? :delete_backup_plan
3270
+ @delete_backup_plan = ::Gapic::Config::Method.new delete_backup_plan_config
3271
+ create_backup_plan_association_config = parent_rpcs.create_backup_plan_association if parent_rpcs.respond_to? :create_backup_plan_association
3272
+ @create_backup_plan_association = ::Gapic::Config::Method.new create_backup_plan_association_config
3273
+ get_backup_plan_association_config = parent_rpcs.get_backup_plan_association if parent_rpcs.respond_to? :get_backup_plan_association
3274
+ @get_backup_plan_association = ::Gapic::Config::Method.new get_backup_plan_association_config
3275
+ list_backup_plan_associations_config = parent_rpcs.list_backup_plan_associations if parent_rpcs.respond_to? :list_backup_plan_associations
3276
+ @list_backup_plan_associations = ::Gapic::Config::Method.new list_backup_plan_associations_config
3277
+ delete_backup_plan_association_config = parent_rpcs.delete_backup_plan_association if parent_rpcs.respond_to? :delete_backup_plan_association
3278
+ @delete_backup_plan_association = ::Gapic::Config::Method.new delete_backup_plan_association_config
3279
+ trigger_backup_config = parent_rpcs.trigger_backup if parent_rpcs.respond_to? :trigger_backup
3280
+ @trigger_backup = ::Gapic::Config::Method.new trigger_backup_config
776
3281
 
777
3282
  yield self if block_given?
778
3283
  end