google-cloud-netapp-v1 0.2.0 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/google/cloud/netapp/v1/active_directory_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/backup_pb.rb +57 -0
- data/lib/google/cloud/netapp/v1/backup_policy_pb.rb +56 -0
- data/lib/google/cloud/netapp/v1/backup_vault_pb.rb +56 -0
- data/lib/google/cloud/netapp/v1/cloud_netapp_service_pb.rb +4 -1
- data/lib/google/cloud/netapp/v1/cloud_netapp_service_services_pb.rb +33 -0
- data/lib/google/cloud/netapp/v1/kms_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/netapp/client.rb +1733 -120
- data/lib/google/cloud/netapp/v1/netapp/paths.rb +59 -0
- data/lib/google/cloud/netapp/v1/netapp/rest/client.rb +1622 -117
- data/lib/google/cloud/netapp/v1/netapp/rest/service_stub.rb +891 -0
- data/lib/google/cloud/netapp/v1/replication_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/snapshot_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/storage_pool_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/version.rb +1 -1
- data/lib/google/cloud/netapp/v1/volume_pb.rb +2 -1
- data/proto_docs/google/api/client.rb +13 -0
- data/proto_docs/google/cloud/netapp/v1/active_directory.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/backup.rb +231 -0
- data/proto_docs/google/cloud/netapp/v1/backup_policy.rb +190 -0
- data/proto_docs/google/cloud/netapp/v1/backup_vault.rb +177 -0
- data/proto_docs/google/cloud/netapp/v1/common.rb +3 -0
- data/proto_docs/google/cloud/netapp/v1/kms.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/replication.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/snapshot.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/storage_pool.rb +4 -3
- data/proto_docs/google/cloud/netapp/v1/volume.rb +31 -2
- metadata +9 -3
@@ -173,6 +173,54 @@ module Google
|
|
173
173
|
|
174
174
|
default_config.rpcs.reverse_replication_direction.timeout = 60.0
|
175
175
|
|
176
|
+
default_config.rpcs.create_backup_vault.timeout = 60.0
|
177
|
+
|
178
|
+
default_config.rpcs.get_backup_vault.timeout = 60.0
|
179
|
+
default_config.rpcs.get_backup_vault.retry_policy = {
|
180
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
181
|
+
}
|
182
|
+
|
183
|
+
default_config.rpcs.list_backup_vaults.timeout = 60.0
|
184
|
+
default_config.rpcs.list_backup_vaults.retry_policy = {
|
185
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
186
|
+
}
|
187
|
+
|
188
|
+
default_config.rpcs.update_backup_vault.timeout = 60.0
|
189
|
+
|
190
|
+
default_config.rpcs.delete_backup_vault.timeout = 60.0
|
191
|
+
|
192
|
+
default_config.rpcs.create_backup.timeout = 60.0
|
193
|
+
|
194
|
+
default_config.rpcs.get_backup.timeout = 60.0
|
195
|
+
default_config.rpcs.get_backup.retry_policy = {
|
196
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
197
|
+
}
|
198
|
+
|
199
|
+
default_config.rpcs.list_backups.timeout = 60.0
|
200
|
+
default_config.rpcs.list_backups.retry_policy = {
|
201
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
202
|
+
}
|
203
|
+
|
204
|
+
default_config.rpcs.delete_backup.timeout = 60.0
|
205
|
+
|
206
|
+
default_config.rpcs.update_backup.timeout = 60.0
|
207
|
+
|
208
|
+
default_config.rpcs.create_backup_policy.timeout = 60.0
|
209
|
+
|
210
|
+
default_config.rpcs.get_backup_policy.timeout = 60.0
|
211
|
+
default_config.rpcs.get_backup_policy.retry_policy = {
|
212
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
213
|
+
}
|
214
|
+
|
215
|
+
default_config.rpcs.list_backup_policies.timeout = 60.0
|
216
|
+
default_config.rpcs.list_backup_policies.retry_policy = {
|
217
|
+
initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
|
218
|
+
}
|
219
|
+
|
220
|
+
default_config.rpcs.update_backup_policy.timeout = 60.0
|
221
|
+
|
222
|
+
default_config.rpcs.delete_backup_policy.timeout = 60.0
|
223
|
+
|
176
224
|
default_config
|
177
225
|
end
|
178
226
|
yield @configure if block_given?
|
@@ -3707,143 +3755,1603 @@ module Google
|
|
3707
3755
|
end
|
3708
3756
|
|
3709
3757
|
##
|
3710
|
-
#
|
3758
|
+
# Creates new backup vault
|
3711
3759
|
#
|
3712
|
-
#
|
3713
|
-
#
|
3714
|
-
#
|
3715
|
-
# applied individually to specific RPCs. See
|
3716
|
-
# {::Google::Cloud::NetApp::V1::NetApp::Client::Configuration::Rpcs}
|
3717
|
-
# for a list of RPCs that can be configured independently.
|
3760
|
+
# @overload create_backup_vault(request, options = nil)
|
3761
|
+
# Pass arguments to `create_backup_vault` via a request object, either of type
|
3762
|
+
# {::Google::Cloud::NetApp::V1::CreateBackupVaultRequest} or an equivalent Hash.
|
3718
3763
|
#
|
3719
|
-
#
|
3720
|
-
#
|
3764
|
+
# @param request [::Google::Cloud::NetApp::V1::CreateBackupVaultRequest, ::Hash]
|
3765
|
+
# A request object representing the call parameters. Required. To specify no
|
3766
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
3767
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
3768
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
3721
3769
|
#
|
3722
|
-
# @
|
3770
|
+
# @overload create_backup_vault(parent: nil, backup_vault_id: nil, backup_vault: nil)
|
3771
|
+
# Pass arguments to `create_backup_vault` via keyword arguments. Note that at
|
3772
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
3773
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
3723
3774
|
#
|
3724
|
-
#
|
3725
|
-
#
|
3726
|
-
#
|
3727
|
-
#
|
3728
|
-
#
|
3729
|
-
#
|
3730
|
-
#
|
3775
|
+
# @param parent [::String]
|
3776
|
+
# Required. The location to create the backup vaults, in the format
|
3777
|
+
# `projects/{project_id}/locations/{location}`
|
3778
|
+
# @param backup_vault_id [::String]
|
3779
|
+
# Required. The ID to use for the backupVault.
|
3780
|
+
# The ID must be unique within the specified location.
|
3781
|
+
# The max supported length is 63 characters.
|
3782
|
+
# This value must start with a lowercase letter followed by up to 62
|
3783
|
+
# lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
|
3784
|
+
# Values that do not match this pattern will trigger an INVALID_ARGUMENT
|
3785
|
+
# error.
|
3786
|
+
# @param backup_vault [::Google::Cloud::NetApp::V1::BackupVault, ::Hash]
|
3787
|
+
# Required. A backupVault resource
|
3731
3788
|
#
|
3732
|
-
#
|
3733
|
-
#
|
3734
|
-
#
|
3735
|
-
# config.rpcs.list_storage_pools.timeout = 20.0
|
3736
|
-
# end
|
3789
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
3790
|
+
# @yieldparam response [::Gapic::Operation]
|
3791
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
3737
3792
|
#
|
3738
|
-
#
|
3739
|
-
# The hostname or hostname:port of the service endpoint.
|
3740
|
-
# Defaults to `"netapp.googleapis.com"`.
|
3741
|
-
# @return [::String]
|
3742
|
-
# @!attribute [rw] credentials
|
3743
|
-
# Credentials to send with calls. You may provide any of the following types:
|
3744
|
-
# * (`String`) The path to a service account key file in JSON format
|
3745
|
-
# * (`Hash`) A service account key as a Hash
|
3746
|
-
# * (`Google::Auth::Credentials`) A googleauth credentials object
|
3747
|
-
# (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
|
3748
|
-
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
3749
|
-
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
3750
|
-
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
3751
|
-
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
3752
|
-
# * (`nil`) indicating no credentials
|
3753
|
-
# @return [::Object]
|
3754
|
-
# @!attribute [rw] scope
|
3755
|
-
# The OAuth scopes
|
3756
|
-
# @return [::Array<::String>]
|
3757
|
-
# @!attribute [rw] lib_name
|
3758
|
-
# The library name as recorded in instrumentation and logging
|
3759
|
-
# @return [::String]
|
3760
|
-
# @!attribute [rw] lib_version
|
3761
|
-
# The library version as recorded in instrumentation and logging
|
3762
|
-
# @return [::String]
|
3763
|
-
# @!attribute [rw] channel_args
|
3764
|
-
# Extra parameters passed to the gRPC channel. Note: this is ignored if a
|
3765
|
-
# `GRPC::Core::Channel` object is provided as the credential.
|
3766
|
-
# @return [::Hash]
|
3767
|
-
# @!attribute [rw] interceptors
|
3768
|
-
# An array of interceptors that are run before calls are executed.
|
3769
|
-
# @return [::Array<::GRPC::ClientInterceptor>]
|
3770
|
-
# @!attribute [rw] timeout
|
3771
|
-
# The call timeout in seconds.
|
3772
|
-
# @return [::Numeric]
|
3773
|
-
# @!attribute [rw] metadata
|
3774
|
-
# Additional gRPC headers to be sent with the call.
|
3775
|
-
# @return [::Hash{::Symbol=>::String}]
|
3776
|
-
# @!attribute [rw] retry_policy
|
3777
|
-
# The retry policy. The value is a hash with the following keys:
|
3778
|
-
# * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
|
3779
|
-
# * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
|
3780
|
-
# * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
|
3781
|
-
# * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
|
3782
|
-
# trigger a retry.
|
3783
|
-
# @return [::Hash]
|
3784
|
-
# @!attribute [rw] quota_project
|
3785
|
-
# A separate project against which to charge quota.
|
3786
|
-
# @return [::String]
|
3793
|
+
# @return [::Gapic::Operation]
|
3787
3794
|
#
|
3788
|
-
|
3789
|
-
|
3795
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
3796
|
+
#
|
3797
|
+
# @example Basic example
|
3798
|
+
# require "google/cloud/netapp/v1"
|
3799
|
+
#
|
3800
|
+
# # Create a client object. The client can be reused for multiple calls.
|
3801
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
3802
|
+
#
|
3803
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
3804
|
+
# request = Google::Cloud::NetApp::V1::CreateBackupVaultRequest.new
|
3805
|
+
#
|
3806
|
+
# # Call the create_backup_vault method.
|
3807
|
+
# result = client.create_backup_vault request
|
3808
|
+
#
|
3809
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
3810
|
+
# # check the status of an operation, cancel it, or wait for results.
|
3811
|
+
# # Here is how to wait for a response.
|
3812
|
+
# result.wait_until_done! timeout: 60
|
3813
|
+
# if result.response?
|
3814
|
+
# p result.response
|
3815
|
+
# else
|
3816
|
+
# puts "No response received."
|
3817
|
+
# end
|
3818
|
+
#
|
3819
|
+
def create_backup_vault request, options = nil
|
3820
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
3790
3821
|
|
3791
|
-
|
3822
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::CreateBackupVaultRequest
|
3792
3823
|
|
3793
|
-
|
3794
|
-
|
3795
|
-
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
3796
|
-
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
3797
|
-
allowed.any? { |klass| klass === value }
|
3798
|
-
end
|
3799
|
-
config_attr :scope, nil, ::String, ::Array, nil
|
3800
|
-
config_attr :lib_name, nil, ::String, nil
|
3801
|
-
config_attr :lib_version, nil, ::String, nil
|
3802
|
-
config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
|
3803
|
-
config_attr :interceptors, nil, ::Array, nil
|
3804
|
-
config_attr :timeout, nil, ::Numeric, nil
|
3805
|
-
config_attr :metadata, nil, ::Hash, nil
|
3806
|
-
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
3807
|
-
config_attr :quota_project, nil, ::String, nil
|
3824
|
+
# Converts hash and nil to an options object
|
3825
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
3808
3826
|
|
3809
|
-
#
|
3810
|
-
|
3811
|
-
@parent_config = parent_config unless parent_config.nil?
|
3827
|
+
# Customize the options with defaults
|
3828
|
+
metadata = @config.rpcs.create_backup_vault.metadata.to_h
|
3812
3829
|
|
3813
|
-
|
3830
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
3831
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
3832
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
3833
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
3834
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
3835
|
+
|
3836
|
+
header_params = {}
|
3837
|
+
if request.parent
|
3838
|
+
header_params["parent"] = request.parent
|
3814
3839
|
end
|
3815
3840
|
|
3816
|
-
|
3817
|
-
|
3818
|
-
|
3819
|
-
|
3820
|
-
|
3821
|
-
|
3822
|
-
|
3823
|
-
|
3824
|
-
|
3825
|
-
|
3841
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
3842
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
3843
|
+
|
3844
|
+
options.apply_defaults timeout: @config.rpcs.create_backup_vault.timeout,
|
3845
|
+
metadata: metadata,
|
3846
|
+
retry_policy: @config.rpcs.create_backup_vault.retry_policy
|
3847
|
+
|
3848
|
+
options.apply_defaults timeout: @config.timeout,
|
3849
|
+
metadata: @config.metadata,
|
3850
|
+
retry_policy: @config.retry_policy
|
3851
|
+
|
3852
|
+
@net_app_stub.call_rpc :create_backup_vault, request, options: options do |response, operation|
|
3853
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
3854
|
+
yield response, operation if block_given?
|
3855
|
+
return response
|
3826
3856
|
end
|
3857
|
+
rescue ::GRPC::BadStatus => e
|
3858
|
+
raise ::Google::Cloud::Error.from_error(e)
|
3859
|
+
end
|
3827
3860
|
|
3828
|
-
|
3829
|
-
|
3830
|
-
|
3831
|
-
|
3832
|
-
|
3833
|
-
|
3861
|
+
##
|
3862
|
+
# Returns the description of the specified backup vault
|
3863
|
+
#
|
3864
|
+
# @overload get_backup_vault(request, options = nil)
|
3865
|
+
# Pass arguments to `get_backup_vault` via a request object, either of type
|
3866
|
+
# {::Google::Cloud::NetApp::V1::GetBackupVaultRequest} or an equivalent Hash.
|
3867
|
+
#
|
3868
|
+
# @param request [::Google::Cloud::NetApp::V1::GetBackupVaultRequest, ::Hash]
|
3869
|
+
# A request object representing the call parameters. Required. To specify no
|
3870
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
3871
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
3872
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
3873
|
+
#
|
3874
|
+
# @overload get_backup_vault(name: nil)
|
3875
|
+
# Pass arguments to `get_backup_vault` via keyword arguments. Note that at
|
3876
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
3877
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
3878
|
+
#
|
3879
|
+
# @param name [::String]
|
3880
|
+
# Required. The backupVault resource name, in the format
|
3881
|
+
# `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}`
|
3882
|
+
#
|
3883
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
3884
|
+
# @yieldparam response [::Google::Cloud::NetApp::V1::BackupVault]
|
3885
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
3886
|
+
#
|
3887
|
+
# @return [::Google::Cloud::NetApp::V1::BackupVault]
|
3888
|
+
#
|
3889
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
3890
|
+
#
|
3891
|
+
# @example Basic example
|
3892
|
+
# require "google/cloud/netapp/v1"
|
3893
|
+
#
|
3894
|
+
# # Create a client object. The client can be reused for multiple calls.
|
3895
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
3896
|
+
#
|
3897
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
3898
|
+
# request = Google::Cloud::NetApp::V1::GetBackupVaultRequest.new
|
3899
|
+
#
|
3900
|
+
# # Call the get_backup_vault method.
|
3901
|
+
# result = client.get_backup_vault request
|
3902
|
+
#
|
3903
|
+
# # The returned object is of type Google::Cloud::NetApp::V1::BackupVault.
|
3904
|
+
# p result
|
3905
|
+
#
|
3906
|
+
def get_backup_vault request, options = nil
|
3907
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
3908
|
+
|
3909
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::GetBackupVaultRequest
|
3910
|
+
|
3911
|
+
# Converts hash and nil to an options object
|
3912
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
3913
|
+
|
3914
|
+
# Customize the options with defaults
|
3915
|
+
metadata = @config.rpcs.get_backup_vault.metadata.to_h
|
3916
|
+
|
3917
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
3918
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
3919
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
3920
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
3921
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
3922
|
+
|
3923
|
+
header_params = {}
|
3924
|
+
if request.name
|
3925
|
+
header_params["name"] = request.name
|
3834
3926
|
end
|
3835
3927
|
|
3836
|
-
|
3837
|
-
|
3838
|
-
|
3839
|
-
|
3840
|
-
|
3841
|
-
|
3842
|
-
|
3843
|
-
|
3844
|
-
|
3845
|
-
|
3846
|
-
|
3928
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
3929
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
3930
|
+
|
3931
|
+
options.apply_defaults timeout: @config.rpcs.get_backup_vault.timeout,
|
3932
|
+
metadata: metadata,
|
3933
|
+
retry_policy: @config.rpcs.get_backup_vault.retry_policy
|
3934
|
+
|
3935
|
+
options.apply_defaults timeout: @config.timeout,
|
3936
|
+
metadata: @config.metadata,
|
3937
|
+
retry_policy: @config.retry_policy
|
3938
|
+
|
3939
|
+
@net_app_stub.call_rpc :get_backup_vault, request, options: options do |response, operation|
|
3940
|
+
yield response, operation if block_given?
|
3941
|
+
return response
|
3942
|
+
end
|
3943
|
+
rescue ::GRPC::BadStatus => e
|
3944
|
+
raise ::Google::Cloud::Error.from_error(e)
|
3945
|
+
end
|
3946
|
+
|
3947
|
+
##
|
3948
|
+
# Returns list of all available backup vaults.
|
3949
|
+
#
|
3950
|
+
# @overload list_backup_vaults(request, options = nil)
|
3951
|
+
# Pass arguments to `list_backup_vaults` via a request object, either of type
|
3952
|
+
# {::Google::Cloud::NetApp::V1::ListBackupVaultsRequest} or an equivalent Hash.
|
3953
|
+
#
|
3954
|
+
# @param request [::Google::Cloud::NetApp::V1::ListBackupVaultsRequest, ::Hash]
|
3955
|
+
# A request object representing the call parameters. Required. To specify no
|
3956
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
3957
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
3958
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
3959
|
+
#
|
3960
|
+
# @overload list_backup_vaults(parent: nil, page_size: nil, page_token: nil, order_by: nil, filter: nil)
|
3961
|
+
# Pass arguments to `list_backup_vaults` via keyword arguments. Note that at
|
3962
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
3963
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
3964
|
+
#
|
3965
|
+
# @param parent [::String]
|
3966
|
+
# Required. The location for which to retrieve backupVault information,
|
3967
|
+
# in the format
|
3968
|
+
# `projects/{project_id}/locations/{location}`.
|
3969
|
+
# @param page_size [::Integer]
|
3970
|
+
# The maximum number of items to return.
|
3971
|
+
# @param page_token [::String]
|
3972
|
+
# The next_page_token value to use if there are additional
|
3973
|
+
# results to retrieve for this list request.
|
3974
|
+
# @param order_by [::String]
|
3975
|
+
# Sort results. Supported values are "name", "name desc" or "" (unsorted).
|
3976
|
+
# @param filter [::String]
|
3977
|
+
# List filter.
|
3978
|
+
#
|
3979
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
3980
|
+
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::BackupVault>]
|
3981
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
3982
|
+
#
|
3983
|
+
# @return [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::BackupVault>]
|
3984
|
+
#
|
3985
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
3986
|
+
#
|
3987
|
+
# @example Basic example
|
3988
|
+
# require "google/cloud/netapp/v1"
|
3989
|
+
#
|
3990
|
+
# # Create a client object. The client can be reused for multiple calls.
|
3991
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
3992
|
+
#
|
3993
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
3994
|
+
# request = Google::Cloud::NetApp::V1::ListBackupVaultsRequest.new
|
3995
|
+
#
|
3996
|
+
# # Call the list_backup_vaults method.
|
3997
|
+
# result = client.list_backup_vaults request
|
3998
|
+
#
|
3999
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
4000
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
4001
|
+
# result.each do |item|
|
4002
|
+
# # Each element is of type ::Google::Cloud::NetApp::V1::BackupVault.
|
4003
|
+
# p item
|
4004
|
+
# end
|
4005
|
+
#
|
4006
|
+
def list_backup_vaults request, options = nil
|
4007
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4008
|
+
|
4009
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::ListBackupVaultsRequest
|
4010
|
+
|
4011
|
+
# Converts hash and nil to an options object
|
4012
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4013
|
+
|
4014
|
+
# Customize the options with defaults
|
4015
|
+
metadata = @config.rpcs.list_backup_vaults.metadata.to_h
|
4016
|
+
|
4017
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4018
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4019
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4020
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4021
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4022
|
+
|
4023
|
+
header_params = {}
|
4024
|
+
if request.parent
|
4025
|
+
header_params["parent"] = request.parent
|
4026
|
+
end
|
4027
|
+
|
4028
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4029
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4030
|
+
|
4031
|
+
options.apply_defaults timeout: @config.rpcs.list_backup_vaults.timeout,
|
4032
|
+
metadata: metadata,
|
4033
|
+
retry_policy: @config.rpcs.list_backup_vaults.retry_policy
|
4034
|
+
|
4035
|
+
options.apply_defaults timeout: @config.timeout,
|
4036
|
+
metadata: @config.metadata,
|
4037
|
+
retry_policy: @config.retry_policy
|
4038
|
+
|
4039
|
+
@net_app_stub.call_rpc :list_backup_vaults, request, options: options do |response, operation|
|
4040
|
+
response = ::Gapic::PagedEnumerable.new @net_app_stub, :list_backup_vaults, request, response, operation, options
|
4041
|
+
yield response, operation if block_given?
|
4042
|
+
return response
|
4043
|
+
end
|
4044
|
+
rescue ::GRPC::BadStatus => e
|
4045
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4046
|
+
end
|
4047
|
+
|
4048
|
+
##
|
4049
|
+
# Updates the settings of a specific backup vault.
|
4050
|
+
#
|
4051
|
+
# @overload update_backup_vault(request, options = nil)
|
4052
|
+
# Pass arguments to `update_backup_vault` via a request object, either of type
|
4053
|
+
# {::Google::Cloud::NetApp::V1::UpdateBackupVaultRequest} or an equivalent Hash.
|
4054
|
+
#
|
4055
|
+
# @param request [::Google::Cloud::NetApp::V1::UpdateBackupVaultRequest, ::Hash]
|
4056
|
+
# A request object representing the call parameters. Required. To specify no
|
4057
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4058
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4059
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4060
|
+
#
|
4061
|
+
# @overload update_backup_vault(update_mask: nil, backup_vault: nil)
|
4062
|
+
# Pass arguments to `update_backup_vault` via keyword arguments. Note that at
|
4063
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4064
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4065
|
+
#
|
4066
|
+
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
4067
|
+
# Required. Field mask is used to specify the fields to be overwritten in the
|
4068
|
+
# Backup resource to be updated.
|
4069
|
+
# The fields specified in the update_mask are relative to the resource, not
|
4070
|
+
# the full request. A field will be overwritten if it is in the mask. If the
|
4071
|
+
# user does not provide a mask then all fields will be overwritten.
|
4072
|
+
# @param backup_vault [::Google::Cloud::NetApp::V1::BackupVault, ::Hash]
|
4073
|
+
# Required. The backupVault being updated
|
4074
|
+
#
|
4075
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4076
|
+
# @yieldparam response [::Gapic::Operation]
|
4077
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4078
|
+
#
|
4079
|
+
# @return [::Gapic::Operation]
|
4080
|
+
#
|
4081
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4082
|
+
#
|
4083
|
+
# @example Basic example
|
4084
|
+
# require "google/cloud/netapp/v1"
|
4085
|
+
#
|
4086
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4087
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4088
|
+
#
|
4089
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4090
|
+
# request = Google::Cloud::NetApp::V1::UpdateBackupVaultRequest.new
|
4091
|
+
#
|
4092
|
+
# # Call the update_backup_vault method.
|
4093
|
+
# result = client.update_backup_vault request
|
4094
|
+
#
|
4095
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4096
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4097
|
+
# # Here is how to wait for a response.
|
4098
|
+
# result.wait_until_done! timeout: 60
|
4099
|
+
# if result.response?
|
4100
|
+
# p result.response
|
4101
|
+
# else
|
4102
|
+
# puts "No response received."
|
4103
|
+
# end
|
4104
|
+
#
|
4105
|
+
def update_backup_vault request, options = nil
|
4106
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4107
|
+
|
4108
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::UpdateBackupVaultRequest
|
4109
|
+
|
4110
|
+
# Converts hash and nil to an options object
|
4111
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4112
|
+
|
4113
|
+
# Customize the options with defaults
|
4114
|
+
metadata = @config.rpcs.update_backup_vault.metadata.to_h
|
4115
|
+
|
4116
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4117
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4118
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4119
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4120
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4121
|
+
|
4122
|
+
header_params = {}
|
4123
|
+
if request.backup_vault&.name
|
4124
|
+
header_params["backup_vault.name"] = request.backup_vault.name
|
4125
|
+
end
|
4126
|
+
|
4127
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4128
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4129
|
+
|
4130
|
+
options.apply_defaults timeout: @config.rpcs.update_backup_vault.timeout,
|
4131
|
+
metadata: metadata,
|
4132
|
+
retry_policy: @config.rpcs.update_backup_vault.retry_policy
|
4133
|
+
|
4134
|
+
options.apply_defaults timeout: @config.timeout,
|
4135
|
+
metadata: @config.metadata,
|
4136
|
+
retry_policy: @config.retry_policy
|
4137
|
+
|
4138
|
+
@net_app_stub.call_rpc :update_backup_vault, request, options: options do |response, operation|
|
4139
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4140
|
+
yield response, operation if block_given?
|
4141
|
+
return response
|
4142
|
+
end
|
4143
|
+
rescue ::GRPC::BadStatus => e
|
4144
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4145
|
+
end
|
4146
|
+
|
4147
|
+
##
|
4148
|
+
# Warning! This operation will permanently delete the backup vault.
|
4149
|
+
#
|
4150
|
+
# @overload delete_backup_vault(request, options = nil)
|
4151
|
+
# Pass arguments to `delete_backup_vault` via a request object, either of type
|
4152
|
+
# {::Google::Cloud::NetApp::V1::DeleteBackupVaultRequest} or an equivalent Hash.
|
4153
|
+
#
|
4154
|
+
# @param request [::Google::Cloud::NetApp::V1::DeleteBackupVaultRequest, ::Hash]
|
4155
|
+
# A request object representing the call parameters. Required. To specify no
|
4156
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4157
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4158
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4159
|
+
#
|
4160
|
+
# @overload delete_backup_vault(name: nil)
|
4161
|
+
# Pass arguments to `delete_backup_vault` via keyword arguments. Note that at
|
4162
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4163
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4164
|
+
#
|
4165
|
+
# @param name [::String]
|
4166
|
+
# Required. The backupVault resource name, in the format
|
4167
|
+
# `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}`
|
4168
|
+
#
|
4169
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4170
|
+
# @yieldparam response [::Gapic::Operation]
|
4171
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4172
|
+
#
|
4173
|
+
# @return [::Gapic::Operation]
|
4174
|
+
#
|
4175
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4176
|
+
#
|
4177
|
+
# @example Basic example
|
4178
|
+
# require "google/cloud/netapp/v1"
|
4179
|
+
#
|
4180
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4181
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4182
|
+
#
|
4183
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4184
|
+
# request = Google::Cloud::NetApp::V1::DeleteBackupVaultRequest.new
|
4185
|
+
#
|
4186
|
+
# # Call the delete_backup_vault method.
|
4187
|
+
# result = client.delete_backup_vault request
|
4188
|
+
#
|
4189
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4190
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4191
|
+
# # Here is how to wait for a response.
|
4192
|
+
# result.wait_until_done! timeout: 60
|
4193
|
+
# if result.response?
|
4194
|
+
# p result.response
|
4195
|
+
# else
|
4196
|
+
# puts "No response received."
|
4197
|
+
# end
|
4198
|
+
#
|
4199
|
+
def delete_backup_vault request, options = nil
|
4200
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4201
|
+
|
4202
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::DeleteBackupVaultRequest
|
4203
|
+
|
4204
|
+
# Converts hash and nil to an options object
|
4205
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4206
|
+
|
4207
|
+
# Customize the options with defaults
|
4208
|
+
metadata = @config.rpcs.delete_backup_vault.metadata.to_h
|
4209
|
+
|
4210
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4211
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4212
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4213
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4214
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4215
|
+
|
4216
|
+
header_params = {}
|
4217
|
+
if request.name
|
4218
|
+
header_params["name"] = request.name
|
4219
|
+
end
|
4220
|
+
|
4221
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4222
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4223
|
+
|
4224
|
+
options.apply_defaults timeout: @config.rpcs.delete_backup_vault.timeout,
|
4225
|
+
metadata: metadata,
|
4226
|
+
retry_policy: @config.rpcs.delete_backup_vault.retry_policy
|
4227
|
+
|
4228
|
+
options.apply_defaults timeout: @config.timeout,
|
4229
|
+
metadata: @config.metadata,
|
4230
|
+
retry_policy: @config.retry_policy
|
4231
|
+
|
4232
|
+
@net_app_stub.call_rpc :delete_backup_vault, request, options: options do |response, operation|
|
4233
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4234
|
+
yield response, operation if block_given?
|
4235
|
+
return response
|
4236
|
+
end
|
4237
|
+
rescue ::GRPC::BadStatus => e
|
4238
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4239
|
+
end
|
4240
|
+
|
4241
|
+
##
|
4242
|
+
# Creates a backup from the volume specified in the request
|
4243
|
+
# The backup can be created from the given snapshot if specified in the
|
4244
|
+
# request. If no snapshot specified, there'll be a new snapshot taken to
|
4245
|
+
# initiate the backup creation.
|
4246
|
+
#
|
4247
|
+
# @overload create_backup(request, options = nil)
|
4248
|
+
# Pass arguments to `create_backup` via a request object, either of type
|
4249
|
+
# {::Google::Cloud::NetApp::V1::CreateBackupRequest} or an equivalent Hash.
|
4250
|
+
#
|
4251
|
+
# @param request [::Google::Cloud::NetApp::V1::CreateBackupRequest, ::Hash]
|
4252
|
+
# A request object representing the call parameters. Required. To specify no
|
4253
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4254
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4255
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4256
|
+
#
|
4257
|
+
# @overload create_backup(parent: nil, backup_id: nil, backup: nil)
|
4258
|
+
# Pass arguments to `create_backup` via keyword arguments. Note that at
|
4259
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4260
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4261
|
+
#
|
4262
|
+
# @param parent [::String]
|
4263
|
+
# Required. The NetApp backupVault to create the backups of, in the format
|
4264
|
+
# `projects/*/locations/*/backupVaults/{backup_vault_id}`
|
4265
|
+
# @param backup_id [::String]
|
4266
|
+
# Required. The ID to use for the backup.
|
4267
|
+
# The ID must be unique within the specified backupVault.
|
4268
|
+
# This value must start with a lowercase letter followed by up to 62
|
4269
|
+
# lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
|
4270
|
+
# Values that do not match this pattern will trigger an INVALID_ARGUMENT
|
4271
|
+
# error.
|
4272
|
+
# @param backup [::Google::Cloud::NetApp::V1::Backup, ::Hash]
|
4273
|
+
# Required. A backup resource
|
4274
|
+
#
|
4275
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4276
|
+
# @yieldparam response [::Gapic::Operation]
|
4277
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4278
|
+
#
|
4279
|
+
# @return [::Gapic::Operation]
|
4280
|
+
#
|
4281
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4282
|
+
#
|
4283
|
+
# @example Basic example
|
4284
|
+
# require "google/cloud/netapp/v1"
|
4285
|
+
#
|
4286
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4287
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4288
|
+
#
|
4289
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4290
|
+
# request = Google::Cloud::NetApp::V1::CreateBackupRequest.new
|
4291
|
+
#
|
4292
|
+
# # Call the create_backup method.
|
4293
|
+
# result = client.create_backup request
|
4294
|
+
#
|
4295
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4296
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4297
|
+
# # Here is how to wait for a response.
|
4298
|
+
# result.wait_until_done! timeout: 60
|
4299
|
+
# if result.response?
|
4300
|
+
# p result.response
|
4301
|
+
# else
|
4302
|
+
# puts "No response received."
|
4303
|
+
# end
|
4304
|
+
#
|
4305
|
+
def create_backup request, options = nil
|
4306
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4307
|
+
|
4308
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::CreateBackupRequest
|
4309
|
+
|
4310
|
+
# Converts hash and nil to an options object
|
4311
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4312
|
+
|
4313
|
+
# Customize the options with defaults
|
4314
|
+
metadata = @config.rpcs.create_backup.metadata.to_h
|
4315
|
+
|
4316
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4317
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4318
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4319
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4320
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4321
|
+
|
4322
|
+
header_params = {}
|
4323
|
+
if request.parent
|
4324
|
+
header_params["parent"] = request.parent
|
4325
|
+
end
|
4326
|
+
|
4327
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4328
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4329
|
+
|
4330
|
+
options.apply_defaults timeout: @config.rpcs.create_backup.timeout,
|
4331
|
+
metadata: metadata,
|
4332
|
+
retry_policy: @config.rpcs.create_backup.retry_policy
|
4333
|
+
|
4334
|
+
options.apply_defaults timeout: @config.timeout,
|
4335
|
+
metadata: @config.metadata,
|
4336
|
+
retry_policy: @config.retry_policy
|
4337
|
+
|
4338
|
+
@net_app_stub.call_rpc :create_backup, request, options: options do |response, operation|
|
4339
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4340
|
+
yield response, operation if block_given?
|
4341
|
+
return response
|
4342
|
+
end
|
4343
|
+
rescue ::GRPC::BadStatus => e
|
4344
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4345
|
+
end
|
4346
|
+
|
4347
|
+
##
|
4348
|
+
# Returns the description of the specified backup
|
4349
|
+
#
|
4350
|
+
# @overload get_backup(request, options = nil)
|
4351
|
+
# Pass arguments to `get_backup` via a request object, either of type
|
4352
|
+
# {::Google::Cloud::NetApp::V1::GetBackupRequest} or an equivalent Hash.
|
4353
|
+
#
|
4354
|
+
# @param request [::Google::Cloud::NetApp::V1::GetBackupRequest, ::Hash]
|
4355
|
+
# A request object representing the call parameters. Required. To specify no
|
4356
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4357
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4358
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4359
|
+
#
|
4360
|
+
# @overload get_backup(name: nil)
|
4361
|
+
# Pass arguments to `get_backup` via keyword arguments. Note that at
|
4362
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4363
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4364
|
+
#
|
4365
|
+
# @param name [::String]
|
4366
|
+
# Required. The backup resource name, in the format
|
4367
|
+
# `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}`
|
4368
|
+
#
|
4369
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4370
|
+
# @yieldparam response [::Google::Cloud::NetApp::V1::Backup]
|
4371
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4372
|
+
#
|
4373
|
+
# @return [::Google::Cloud::NetApp::V1::Backup]
|
4374
|
+
#
|
4375
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4376
|
+
#
|
4377
|
+
# @example Basic example
|
4378
|
+
# require "google/cloud/netapp/v1"
|
4379
|
+
#
|
4380
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4381
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4382
|
+
#
|
4383
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4384
|
+
# request = Google::Cloud::NetApp::V1::GetBackupRequest.new
|
4385
|
+
#
|
4386
|
+
# # Call the get_backup method.
|
4387
|
+
# result = client.get_backup request
|
4388
|
+
#
|
4389
|
+
# # The returned object is of type Google::Cloud::NetApp::V1::Backup.
|
4390
|
+
# p result
|
4391
|
+
#
|
4392
|
+
def get_backup request, options = nil
|
4393
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4394
|
+
|
4395
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::GetBackupRequest
|
4396
|
+
|
4397
|
+
# Converts hash and nil to an options object
|
4398
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4399
|
+
|
4400
|
+
# Customize the options with defaults
|
4401
|
+
metadata = @config.rpcs.get_backup.metadata.to_h
|
4402
|
+
|
4403
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4404
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4405
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4406
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4407
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4408
|
+
|
4409
|
+
header_params = {}
|
4410
|
+
if request.name
|
4411
|
+
header_params["name"] = request.name
|
4412
|
+
end
|
4413
|
+
|
4414
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4415
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4416
|
+
|
4417
|
+
options.apply_defaults timeout: @config.rpcs.get_backup.timeout,
|
4418
|
+
metadata: metadata,
|
4419
|
+
retry_policy: @config.rpcs.get_backup.retry_policy
|
4420
|
+
|
4421
|
+
options.apply_defaults timeout: @config.timeout,
|
4422
|
+
metadata: @config.metadata,
|
4423
|
+
retry_policy: @config.retry_policy
|
4424
|
+
|
4425
|
+
@net_app_stub.call_rpc :get_backup, request, options: options do |response, operation|
|
4426
|
+
yield response, operation if block_given?
|
4427
|
+
return response
|
4428
|
+
end
|
4429
|
+
rescue ::GRPC::BadStatus => e
|
4430
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4431
|
+
end
|
4432
|
+
|
4433
|
+
##
|
4434
|
+
# Returns descriptions of all backups for a backupVault.
|
4435
|
+
#
|
4436
|
+
# @overload list_backups(request, options = nil)
|
4437
|
+
# Pass arguments to `list_backups` via a request object, either of type
|
4438
|
+
# {::Google::Cloud::NetApp::V1::ListBackupsRequest} or an equivalent Hash.
|
4439
|
+
#
|
4440
|
+
# @param request [::Google::Cloud::NetApp::V1::ListBackupsRequest, ::Hash]
|
4441
|
+
# A request object representing the call parameters. Required. To specify no
|
4442
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4443
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4444
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4445
|
+
#
|
4446
|
+
# @overload list_backups(parent: nil, page_size: nil, page_token: nil, order_by: nil, filter: nil)
|
4447
|
+
# Pass arguments to `list_backups` via keyword arguments. Note that at
|
4448
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4449
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4450
|
+
#
|
4451
|
+
# @param parent [::String]
|
4452
|
+
# Required. The backupVault for which to retrieve backup information,
|
4453
|
+
# in the format
|
4454
|
+
# `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}`.
|
4455
|
+
# To retrieve backup information for all locations, use "-" for the
|
4456
|
+
# `{location}` value.
|
4457
|
+
# To retrieve backup information for all backupVaults, use "-" for the
|
4458
|
+
# `{backup_vault_id}` value.
|
4459
|
+
# To retrieve backup information for a volume, use "-" for the
|
4460
|
+
# `{backup_vault_id}` value and specify volume full name with the filter.
|
4461
|
+
# @param page_size [::Integer]
|
4462
|
+
# The maximum number of items to return. The service may return fewer
|
4463
|
+
# than this value. The maximum value
|
4464
|
+
# is 1000; values above 1000 will be coerced to 1000.
|
4465
|
+
# @param page_token [::String]
|
4466
|
+
# The next_page_token value to use if there are additional
|
4467
|
+
# results to retrieve for this list request.
|
4468
|
+
# @param order_by [::String]
|
4469
|
+
# Sort results. Supported values are "name", "name desc" or "" (unsorted).
|
4470
|
+
# @param filter [::String]
|
4471
|
+
# The standard list filter.
|
4472
|
+
# If specified, backups will be returned based on the attribute name that
|
4473
|
+
# matches the filter expression. If empty, then no backups are filtered out.
|
4474
|
+
# See https://google.aip.dev/160
|
4475
|
+
#
|
4476
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4477
|
+
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::Backup>]
|
4478
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4479
|
+
#
|
4480
|
+
# @return [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::Backup>]
|
4481
|
+
#
|
4482
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4483
|
+
#
|
4484
|
+
# @example Basic example
|
4485
|
+
# require "google/cloud/netapp/v1"
|
4486
|
+
#
|
4487
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4488
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4489
|
+
#
|
4490
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4491
|
+
# request = Google::Cloud::NetApp::V1::ListBackupsRequest.new
|
4492
|
+
#
|
4493
|
+
# # Call the list_backups method.
|
4494
|
+
# result = client.list_backups request
|
4495
|
+
#
|
4496
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
4497
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
4498
|
+
# result.each do |item|
|
4499
|
+
# # Each element is of type ::Google::Cloud::NetApp::V1::Backup.
|
4500
|
+
# p item
|
4501
|
+
# end
|
4502
|
+
#
|
4503
|
+
def list_backups request, options = nil
|
4504
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4505
|
+
|
4506
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::ListBackupsRequest
|
4507
|
+
|
4508
|
+
# Converts hash and nil to an options object
|
4509
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4510
|
+
|
4511
|
+
# Customize the options with defaults
|
4512
|
+
metadata = @config.rpcs.list_backups.metadata.to_h
|
4513
|
+
|
4514
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4515
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4516
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4517
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4518
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4519
|
+
|
4520
|
+
header_params = {}
|
4521
|
+
if request.parent
|
4522
|
+
header_params["parent"] = request.parent
|
4523
|
+
end
|
4524
|
+
|
4525
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4526
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4527
|
+
|
4528
|
+
options.apply_defaults timeout: @config.rpcs.list_backups.timeout,
|
4529
|
+
metadata: metadata,
|
4530
|
+
retry_policy: @config.rpcs.list_backups.retry_policy
|
4531
|
+
|
4532
|
+
options.apply_defaults timeout: @config.timeout,
|
4533
|
+
metadata: @config.metadata,
|
4534
|
+
retry_policy: @config.retry_policy
|
4535
|
+
|
4536
|
+
@net_app_stub.call_rpc :list_backups, request, options: options do |response, operation|
|
4537
|
+
response = ::Gapic::PagedEnumerable.new @net_app_stub, :list_backups, request, response, operation, options
|
4538
|
+
yield response, operation if block_given?
|
4539
|
+
return response
|
4540
|
+
end
|
4541
|
+
rescue ::GRPC::BadStatus => e
|
4542
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4543
|
+
end
|
4544
|
+
|
4545
|
+
##
|
4546
|
+
# Warning! This operation will permanently delete the backup.
|
4547
|
+
#
|
4548
|
+
# @overload delete_backup(request, options = nil)
|
4549
|
+
# Pass arguments to `delete_backup` via a request object, either of type
|
4550
|
+
# {::Google::Cloud::NetApp::V1::DeleteBackupRequest} or an equivalent Hash.
|
4551
|
+
#
|
4552
|
+
# @param request [::Google::Cloud::NetApp::V1::DeleteBackupRequest, ::Hash]
|
4553
|
+
# A request object representing the call parameters. Required. To specify no
|
4554
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4555
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4556
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4557
|
+
#
|
4558
|
+
# @overload delete_backup(name: nil)
|
4559
|
+
# Pass arguments to `delete_backup` via keyword arguments. Note that at
|
4560
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4561
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4562
|
+
#
|
4563
|
+
# @param name [::String]
|
4564
|
+
# Required. The backup resource name, in the format
|
4565
|
+
# `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}`
|
4566
|
+
#
|
4567
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4568
|
+
# @yieldparam response [::Gapic::Operation]
|
4569
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4570
|
+
#
|
4571
|
+
# @return [::Gapic::Operation]
|
4572
|
+
#
|
4573
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4574
|
+
#
|
4575
|
+
# @example Basic example
|
4576
|
+
# require "google/cloud/netapp/v1"
|
4577
|
+
#
|
4578
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4579
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4580
|
+
#
|
4581
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4582
|
+
# request = Google::Cloud::NetApp::V1::DeleteBackupRequest.new
|
4583
|
+
#
|
4584
|
+
# # Call the delete_backup method.
|
4585
|
+
# result = client.delete_backup request
|
4586
|
+
#
|
4587
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4588
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4589
|
+
# # Here is how to wait for a response.
|
4590
|
+
# result.wait_until_done! timeout: 60
|
4591
|
+
# if result.response?
|
4592
|
+
# p result.response
|
4593
|
+
# else
|
4594
|
+
# puts "No response received."
|
4595
|
+
# end
|
4596
|
+
#
|
4597
|
+
def delete_backup request, options = nil
|
4598
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4599
|
+
|
4600
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::DeleteBackupRequest
|
4601
|
+
|
4602
|
+
# Converts hash and nil to an options object
|
4603
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4604
|
+
|
4605
|
+
# Customize the options with defaults
|
4606
|
+
metadata = @config.rpcs.delete_backup.metadata.to_h
|
4607
|
+
|
4608
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4609
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4610
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4611
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4612
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4613
|
+
|
4614
|
+
header_params = {}
|
4615
|
+
if request.name
|
4616
|
+
header_params["name"] = request.name
|
4617
|
+
end
|
4618
|
+
|
4619
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4620
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4621
|
+
|
4622
|
+
options.apply_defaults timeout: @config.rpcs.delete_backup.timeout,
|
4623
|
+
metadata: metadata,
|
4624
|
+
retry_policy: @config.rpcs.delete_backup.retry_policy
|
4625
|
+
|
4626
|
+
options.apply_defaults timeout: @config.timeout,
|
4627
|
+
metadata: @config.metadata,
|
4628
|
+
retry_policy: @config.retry_policy
|
4629
|
+
|
4630
|
+
@net_app_stub.call_rpc :delete_backup, request, options: options do |response, operation|
|
4631
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4632
|
+
yield response, operation if block_given?
|
4633
|
+
return response
|
4634
|
+
end
|
4635
|
+
rescue ::GRPC::BadStatus => e
|
4636
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4637
|
+
end
|
4638
|
+
|
4639
|
+
##
|
4640
|
+
# Update backup with full spec.
|
4641
|
+
#
|
4642
|
+
# @overload update_backup(request, options = nil)
|
4643
|
+
# Pass arguments to `update_backup` via a request object, either of type
|
4644
|
+
# {::Google::Cloud::NetApp::V1::UpdateBackupRequest} or an equivalent Hash.
|
4645
|
+
#
|
4646
|
+
# @param request [::Google::Cloud::NetApp::V1::UpdateBackupRequest, ::Hash]
|
4647
|
+
# A request object representing the call parameters. Required. To specify no
|
4648
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4649
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4650
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4651
|
+
#
|
4652
|
+
# @overload update_backup(update_mask: nil, backup: nil)
|
4653
|
+
# Pass arguments to `update_backup` via keyword arguments. Note that at
|
4654
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4655
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4656
|
+
#
|
4657
|
+
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
4658
|
+
# Required. Field mask is used to specify the fields to be overwritten in the
|
4659
|
+
# Backup resource to be updated.
|
4660
|
+
# The fields specified in the update_mask are relative to the resource, not
|
4661
|
+
# the full request. A field will be overwritten if it is in the mask. If the
|
4662
|
+
# user does not provide a mask then all fields will be overwritten.
|
4663
|
+
# @param backup [::Google::Cloud::NetApp::V1::Backup, ::Hash]
|
4664
|
+
# Required. The backup being updated
|
4665
|
+
#
|
4666
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4667
|
+
# @yieldparam response [::Gapic::Operation]
|
4668
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4669
|
+
#
|
4670
|
+
# @return [::Gapic::Operation]
|
4671
|
+
#
|
4672
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4673
|
+
#
|
4674
|
+
# @example Basic example
|
4675
|
+
# require "google/cloud/netapp/v1"
|
4676
|
+
#
|
4677
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4678
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4679
|
+
#
|
4680
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4681
|
+
# request = Google::Cloud::NetApp::V1::UpdateBackupRequest.new
|
4682
|
+
#
|
4683
|
+
# # Call the update_backup method.
|
4684
|
+
# result = client.update_backup request
|
4685
|
+
#
|
4686
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4687
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4688
|
+
# # Here is how to wait for a response.
|
4689
|
+
# result.wait_until_done! timeout: 60
|
4690
|
+
# if result.response?
|
4691
|
+
# p result.response
|
4692
|
+
# else
|
4693
|
+
# puts "No response received."
|
4694
|
+
# end
|
4695
|
+
#
|
4696
|
+
def update_backup request, options = nil
|
4697
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4698
|
+
|
4699
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::UpdateBackupRequest
|
4700
|
+
|
4701
|
+
# Converts hash and nil to an options object
|
4702
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4703
|
+
|
4704
|
+
# Customize the options with defaults
|
4705
|
+
metadata = @config.rpcs.update_backup.metadata.to_h
|
4706
|
+
|
4707
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4708
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4709
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4710
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4711
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4712
|
+
|
4713
|
+
header_params = {}
|
4714
|
+
if request.backup&.name
|
4715
|
+
header_params["backup.name"] = request.backup.name
|
4716
|
+
end
|
4717
|
+
|
4718
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4719
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4720
|
+
|
4721
|
+
options.apply_defaults timeout: @config.rpcs.update_backup.timeout,
|
4722
|
+
metadata: metadata,
|
4723
|
+
retry_policy: @config.rpcs.update_backup.retry_policy
|
4724
|
+
|
4725
|
+
options.apply_defaults timeout: @config.timeout,
|
4726
|
+
metadata: @config.metadata,
|
4727
|
+
retry_policy: @config.retry_policy
|
4728
|
+
|
4729
|
+
@net_app_stub.call_rpc :update_backup, request, options: options do |response, operation|
|
4730
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4731
|
+
yield response, operation if block_given?
|
4732
|
+
return response
|
4733
|
+
end
|
4734
|
+
rescue ::GRPC::BadStatus => e
|
4735
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4736
|
+
end
|
4737
|
+
|
4738
|
+
##
|
4739
|
+
# Creates new backup policy
|
4740
|
+
#
|
4741
|
+
# @overload create_backup_policy(request, options = nil)
|
4742
|
+
# Pass arguments to `create_backup_policy` via a request object, either of type
|
4743
|
+
# {::Google::Cloud::NetApp::V1::CreateBackupPolicyRequest} or an equivalent Hash.
|
4744
|
+
#
|
4745
|
+
# @param request [::Google::Cloud::NetApp::V1::CreateBackupPolicyRequest, ::Hash]
|
4746
|
+
# A request object representing the call parameters. Required. To specify no
|
4747
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4748
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4749
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4750
|
+
#
|
4751
|
+
# @overload create_backup_policy(parent: nil, backup_policy: nil, backup_policy_id: nil)
|
4752
|
+
# Pass arguments to `create_backup_policy` via keyword arguments. Note that at
|
4753
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4754
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4755
|
+
#
|
4756
|
+
# @param parent [::String]
|
4757
|
+
# Required. The location to create the backup policies of, in the format
|
4758
|
+
# `projects/{project_id}/locations/{location}`
|
4759
|
+
# @param backup_policy [::Google::Cloud::NetApp::V1::BackupPolicy, ::Hash]
|
4760
|
+
# Required. A backupPolicy resource
|
4761
|
+
# @param backup_policy_id [::String]
|
4762
|
+
# Required. The ID to use for the backup policy.
|
4763
|
+
# The ID must be unique within the specified location.
|
4764
|
+
# This value must start with a lowercase letter followed by up to 62
|
4765
|
+
# lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
|
4766
|
+
#
|
4767
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4768
|
+
# @yieldparam response [::Gapic::Operation]
|
4769
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4770
|
+
#
|
4771
|
+
# @return [::Gapic::Operation]
|
4772
|
+
#
|
4773
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4774
|
+
#
|
4775
|
+
# @example Basic example
|
4776
|
+
# require "google/cloud/netapp/v1"
|
4777
|
+
#
|
4778
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4779
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4780
|
+
#
|
4781
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4782
|
+
# request = Google::Cloud::NetApp::V1::CreateBackupPolicyRequest.new
|
4783
|
+
#
|
4784
|
+
# # Call the create_backup_policy method.
|
4785
|
+
# result = client.create_backup_policy request
|
4786
|
+
#
|
4787
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
4788
|
+
# # check the status of an operation, cancel it, or wait for results.
|
4789
|
+
# # Here is how to wait for a response.
|
4790
|
+
# result.wait_until_done! timeout: 60
|
4791
|
+
# if result.response?
|
4792
|
+
# p result.response
|
4793
|
+
# else
|
4794
|
+
# puts "No response received."
|
4795
|
+
# end
|
4796
|
+
#
|
4797
|
+
def create_backup_policy request, options = nil
|
4798
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4799
|
+
|
4800
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::CreateBackupPolicyRequest
|
4801
|
+
|
4802
|
+
# Converts hash and nil to an options object
|
4803
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4804
|
+
|
4805
|
+
# Customize the options with defaults
|
4806
|
+
metadata = @config.rpcs.create_backup_policy.metadata.to_h
|
4807
|
+
|
4808
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4809
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4810
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4811
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4812
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4813
|
+
|
4814
|
+
header_params = {}
|
4815
|
+
if request.parent
|
4816
|
+
header_params["parent"] = request.parent
|
4817
|
+
end
|
4818
|
+
|
4819
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4820
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4821
|
+
|
4822
|
+
options.apply_defaults timeout: @config.rpcs.create_backup_policy.timeout,
|
4823
|
+
metadata: metadata,
|
4824
|
+
retry_policy: @config.rpcs.create_backup_policy.retry_policy
|
4825
|
+
|
4826
|
+
options.apply_defaults timeout: @config.timeout,
|
4827
|
+
metadata: @config.metadata,
|
4828
|
+
retry_policy: @config.retry_policy
|
4829
|
+
|
4830
|
+
@net_app_stub.call_rpc :create_backup_policy, request, options: options do |response, operation|
|
4831
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
4832
|
+
yield response, operation if block_given?
|
4833
|
+
return response
|
4834
|
+
end
|
4835
|
+
rescue ::GRPC::BadStatus => e
|
4836
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4837
|
+
end
|
4838
|
+
|
4839
|
+
##
|
4840
|
+
# Returns the description of the specified backup policy by backup_policy_id.
|
4841
|
+
#
|
4842
|
+
# @overload get_backup_policy(request, options = nil)
|
4843
|
+
# Pass arguments to `get_backup_policy` via a request object, either of type
|
4844
|
+
# {::Google::Cloud::NetApp::V1::GetBackupPolicyRequest} or an equivalent Hash.
|
4845
|
+
#
|
4846
|
+
# @param request [::Google::Cloud::NetApp::V1::GetBackupPolicyRequest, ::Hash]
|
4847
|
+
# A request object representing the call parameters. Required. To specify no
|
4848
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4849
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4850
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4851
|
+
#
|
4852
|
+
# @overload get_backup_policy(name: nil)
|
4853
|
+
# Pass arguments to `get_backup_policy` via keyword arguments. Note that at
|
4854
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4855
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4856
|
+
#
|
4857
|
+
# @param name [::String]
|
4858
|
+
# Required. The backupPolicy resource name, in the format
|
4859
|
+
# `projects/{project_id}/locations/{location}/backupPolicies/{backup_policy_id}`
|
4860
|
+
#
|
4861
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4862
|
+
# @yieldparam response [::Google::Cloud::NetApp::V1::BackupPolicy]
|
4863
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4864
|
+
#
|
4865
|
+
# @return [::Google::Cloud::NetApp::V1::BackupPolicy]
|
4866
|
+
#
|
4867
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4868
|
+
#
|
4869
|
+
# @example Basic example
|
4870
|
+
# require "google/cloud/netapp/v1"
|
4871
|
+
#
|
4872
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4873
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4874
|
+
#
|
4875
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4876
|
+
# request = Google::Cloud::NetApp::V1::GetBackupPolicyRequest.new
|
4877
|
+
#
|
4878
|
+
# # Call the get_backup_policy method.
|
4879
|
+
# result = client.get_backup_policy request
|
4880
|
+
#
|
4881
|
+
# # The returned object is of type Google::Cloud::NetApp::V1::BackupPolicy.
|
4882
|
+
# p result
|
4883
|
+
#
|
4884
|
+
def get_backup_policy request, options = nil
|
4885
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4886
|
+
|
4887
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::GetBackupPolicyRequest
|
4888
|
+
|
4889
|
+
# Converts hash and nil to an options object
|
4890
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4891
|
+
|
4892
|
+
# Customize the options with defaults
|
4893
|
+
metadata = @config.rpcs.get_backup_policy.metadata.to_h
|
4894
|
+
|
4895
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4896
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4897
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4898
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4899
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4900
|
+
|
4901
|
+
header_params = {}
|
4902
|
+
if request.name
|
4903
|
+
header_params["name"] = request.name
|
4904
|
+
end
|
4905
|
+
|
4906
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
4907
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
4908
|
+
|
4909
|
+
options.apply_defaults timeout: @config.rpcs.get_backup_policy.timeout,
|
4910
|
+
metadata: metadata,
|
4911
|
+
retry_policy: @config.rpcs.get_backup_policy.retry_policy
|
4912
|
+
|
4913
|
+
options.apply_defaults timeout: @config.timeout,
|
4914
|
+
metadata: @config.metadata,
|
4915
|
+
retry_policy: @config.retry_policy
|
4916
|
+
|
4917
|
+
@net_app_stub.call_rpc :get_backup_policy, request, options: options do |response, operation|
|
4918
|
+
yield response, operation if block_given?
|
4919
|
+
return response
|
4920
|
+
end
|
4921
|
+
rescue ::GRPC::BadStatus => e
|
4922
|
+
raise ::Google::Cloud::Error.from_error(e)
|
4923
|
+
end
|
4924
|
+
|
4925
|
+
##
|
4926
|
+
# Returns list of all available backup policies.
|
4927
|
+
#
|
4928
|
+
# @overload list_backup_policies(request, options = nil)
|
4929
|
+
# Pass arguments to `list_backup_policies` via a request object, either of type
|
4930
|
+
# {::Google::Cloud::NetApp::V1::ListBackupPoliciesRequest} or an equivalent Hash.
|
4931
|
+
#
|
4932
|
+
# @param request [::Google::Cloud::NetApp::V1::ListBackupPoliciesRequest, ::Hash]
|
4933
|
+
# A request object representing the call parameters. Required. To specify no
|
4934
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
4935
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
4936
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
4937
|
+
#
|
4938
|
+
# @overload list_backup_policies(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
|
4939
|
+
# Pass arguments to `list_backup_policies` via keyword arguments. Note that at
|
4940
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
4941
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
4942
|
+
#
|
4943
|
+
# @param parent [::String]
|
4944
|
+
# Required. Parent value for ListBackupPoliciesRequest
|
4945
|
+
# @param page_size [::Integer]
|
4946
|
+
# Requested page size. Server may return fewer items than requested.
|
4947
|
+
# If unspecified, the server will pick an appropriate default.
|
4948
|
+
# @param page_token [::String]
|
4949
|
+
# A token identifying a page of results the server should return.
|
4950
|
+
# @param filter [::String]
|
4951
|
+
# Filtering results
|
4952
|
+
# @param order_by [::String]
|
4953
|
+
# Hint for how to order the results
|
4954
|
+
#
|
4955
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
4956
|
+
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::BackupPolicy>]
|
4957
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
4958
|
+
#
|
4959
|
+
# @return [::Gapic::PagedEnumerable<::Google::Cloud::NetApp::V1::BackupPolicy>]
|
4960
|
+
#
|
4961
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
4962
|
+
#
|
4963
|
+
# @example Basic example
|
4964
|
+
# require "google/cloud/netapp/v1"
|
4965
|
+
#
|
4966
|
+
# # Create a client object. The client can be reused for multiple calls.
|
4967
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
4968
|
+
#
|
4969
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
4970
|
+
# request = Google::Cloud::NetApp::V1::ListBackupPoliciesRequest.new
|
4971
|
+
#
|
4972
|
+
# # Call the list_backup_policies method.
|
4973
|
+
# result = client.list_backup_policies request
|
4974
|
+
#
|
4975
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
4976
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
4977
|
+
# result.each do |item|
|
4978
|
+
# # Each element is of type ::Google::Cloud::NetApp::V1::BackupPolicy.
|
4979
|
+
# p item
|
4980
|
+
# end
|
4981
|
+
#
|
4982
|
+
def list_backup_policies request, options = nil
|
4983
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
4984
|
+
|
4985
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::ListBackupPoliciesRequest
|
4986
|
+
|
4987
|
+
# Converts hash and nil to an options object
|
4988
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
4989
|
+
|
4990
|
+
# Customize the options with defaults
|
4991
|
+
metadata = @config.rpcs.list_backup_policies.metadata.to_h
|
4992
|
+
|
4993
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
4994
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
4995
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
4996
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
4997
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
4998
|
+
|
4999
|
+
header_params = {}
|
5000
|
+
if request.parent
|
5001
|
+
header_params["parent"] = request.parent
|
5002
|
+
end
|
5003
|
+
|
5004
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
5005
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
5006
|
+
|
5007
|
+
options.apply_defaults timeout: @config.rpcs.list_backup_policies.timeout,
|
5008
|
+
metadata: metadata,
|
5009
|
+
retry_policy: @config.rpcs.list_backup_policies.retry_policy
|
5010
|
+
|
5011
|
+
options.apply_defaults timeout: @config.timeout,
|
5012
|
+
metadata: @config.metadata,
|
5013
|
+
retry_policy: @config.retry_policy
|
5014
|
+
|
5015
|
+
@net_app_stub.call_rpc :list_backup_policies, request, options: options do |response, operation|
|
5016
|
+
response = ::Gapic::PagedEnumerable.new @net_app_stub, :list_backup_policies, request, response, operation, options
|
5017
|
+
yield response, operation if block_given?
|
5018
|
+
return response
|
5019
|
+
end
|
5020
|
+
rescue ::GRPC::BadStatus => e
|
5021
|
+
raise ::Google::Cloud::Error.from_error(e)
|
5022
|
+
end
|
5023
|
+
|
5024
|
+
##
|
5025
|
+
# Updates settings of a specific backup policy.
|
5026
|
+
#
|
5027
|
+
# @overload update_backup_policy(request, options = nil)
|
5028
|
+
# Pass arguments to `update_backup_policy` via a request object, either of type
|
5029
|
+
# {::Google::Cloud::NetApp::V1::UpdateBackupPolicyRequest} or an equivalent Hash.
|
5030
|
+
#
|
5031
|
+
# @param request [::Google::Cloud::NetApp::V1::UpdateBackupPolicyRequest, ::Hash]
|
5032
|
+
# A request object representing the call parameters. Required. To specify no
|
5033
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
5034
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
5035
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
5036
|
+
#
|
5037
|
+
# @overload update_backup_policy(update_mask: nil, backup_policy: nil)
|
5038
|
+
# Pass arguments to `update_backup_policy` via keyword arguments. Note that at
|
5039
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
5040
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
5041
|
+
#
|
5042
|
+
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
5043
|
+
# Required. Field mask is used to specify the fields to be overwritten in the
|
5044
|
+
# Backup Policy resource by the update.
|
5045
|
+
# The fields specified in the update_mask are relative to the resource, not
|
5046
|
+
# the full request. A field will be overwritten if it is in the mask. If the
|
5047
|
+
# user does not provide a mask then all fields will be overwritten.
|
5048
|
+
# @param backup_policy [::Google::Cloud::NetApp::V1::BackupPolicy, ::Hash]
|
5049
|
+
# Required. The backup policy being updated
|
5050
|
+
#
|
5051
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
5052
|
+
# @yieldparam response [::Gapic::Operation]
|
5053
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
5054
|
+
#
|
5055
|
+
# @return [::Gapic::Operation]
|
5056
|
+
#
|
5057
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
5058
|
+
#
|
5059
|
+
# @example Basic example
|
5060
|
+
# require "google/cloud/netapp/v1"
|
5061
|
+
#
|
5062
|
+
# # Create a client object. The client can be reused for multiple calls.
|
5063
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
5064
|
+
#
|
5065
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
5066
|
+
# request = Google::Cloud::NetApp::V1::UpdateBackupPolicyRequest.new
|
5067
|
+
#
|
5068
|
+
# # Call the update_backup_policy method.
|
5069
|
+
# result = client.update_backup_policy request
|
5070
|
+
#
|
5071
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
5072
|
+
# # check the status of an operation, cancel it, or wait for results.
|
5073
|
+
# # Here is how to wait for a response.
|
5074
|
+
# result.wait_until_done! timeout: 60
|
5075
|
+
# if result.response?
|
5076
|
+
# p result.response
|
5077
|
+
# else
|
5078
|
+
# puts "No response received."
|
5079
|
+
# end
|
5080
|
+
#
|
5081
|
+
def update_backup_policy request, options = nil
|
5082
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
5083
|
+
|
5084
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::UpdateBackupPolicyRequest
|
5085
|
+
|
5086
|
+
# Converts hash and nil to an options object
|
5087
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
5088
|
+
|
5089
|
+
# Customize the options with defaults
|
5090
|
+
metadata = @config.rpcs.update_backup_policy.metadata.to_h
|
5091
|
+
|
5092
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
5093
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
5094
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
5095
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
5096
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
5097
|
+
|
5098
|
+
header_params = {}
|
5099
|
+
if request.backup_policy&.name
|
5100
|
+
header_params["backup_policy.name"] = request.backup_policy.name
|
5101
|
+
end
|
5102
|
+
|
5103
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
5104
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
5105
|
+
|
5106
|
+
options.apply_defaults timeout: @config.rpcs.update_backup_policy.timeout,
|
5107
|
+
metadata: metadata,
|
5108
|
+
retry_policy: @config.rpcs.update_backup_policy.retry_policy
|
5109
|
+
|
5110
|
+
options.apply_defaults timeout: @config.timeout,
|
5111
|
+
metadata: @config.metadata,
|
5112
|
+
retry_policy: @config.retry_policy
|
5113
|
+
|
5114
|
+
@net_app_stub.call_rpc :update_backup_policy, request, options: options do |response, operation|
|
5115
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
5116
|
+
yield response, operation if block_given?
|
5117
|
+
return response
|
5118
|
+
end
|
5119
|
+
rescue ::GRPC::BadStatus => e
|
5120
|
+
raise ::Google::Cloud::Error.from_error(e)
|
5121
|
+
end
|
5122
|
+
|
5123
|
+
##
|
5124
|
+
# Warning! This operation will permanently delete the backup policy.
|
5125
|
+
#
|
5126
|
+
# @overload delete_backup_policy(request, options = nil)
|
5127
|
+
# Pass arguments to `delete_backup_policy` via a request object, either of type
|
5128
|
+
# {::Google::Cloud::NetApp::V1::DeleteBackupPolicyRequest} or an equivalent Hash.
|
5129
|
+
#
|
5130
|
+
# @param request [::Google::Cloud::NetApp::V1::DeleteBackupPolicyRequest, ::Hash]
|
5131
|
+
# A request object representing the call parameters. Required. To specify no
|
5132
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
5133
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
5134
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
5135
|
+
#
|
5136
|
+
# @overload delete_backup_policy(name: nil)
|
5137
|
+
# Pass arguments to `delete_backup_policy` via keyword arguments. Note that at
|
5138
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
5139
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
5140
|
+
#
|
5141
|
+
# @param name [::String]
|
5142
|
+
# Required. The backup policy resource name, in the format
|
5143
|
+
# `projects/{project_id}/locations/{location}/backupPolicies/{backup_policy_id}`
|
5144
|
+
#
|
5145
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
5146
|
+
# @yieldparam response [::Gapic::Operation]
|
5147
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
5148
|
+
#
|
5149
|
+
# @return [::Gapic::Operation]
|
5150
|
+
#
|
5151
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
5152
|
+
#
|
5153
|
+
# @example Basic example
|
5154
|
+
# require "google/cloud/netapp/v1"
|
5155
|
+
#
|
5156
|
+
# # Create a client object. The client can be reused for multiple calls.
|
5157
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Client.new
|
5158
|
+
#
|
5159
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
5160
|
+
# request = Google::Cloud::NetApp::V1::DeleteBackupPolicyRequest.new
|
5161
|
+
#
|
5162
|
+
# # Call the delete_backup_policy method.
|
5163
|
+
# result = client.delete_backup_policy request
|
5164
|
+
#
|
5165
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
5166
|
+
# # check the status of an operation, cancel it, or wait for results.
|
5167
|
+
# # Here is how to wait for a response.
|
5168
|
+
# result.wait_until_done! timeout: 60
|
5169
|
+
# if result.response?
|
5170
|
+
# p result.response
|
5171
|
+
# else
|
5172
|
+
# puts "No response received."
|
5173
|
+
# end
|
5174
|
+
#
|
5175
|
+
def delete_backup_policy request, options = nil
|
5176
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
5177
|
+
|
5178
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::DeleteBackupPolicyRequest
|
5179
|
+
|
5180
|
+
# Converts hash and nil to an options object
|
5181
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
5182
|
+
|
5183
|
+
# Customize the options with defaults
|
5184
|
+
metadata = @config.rpcs.delete_backup_policy.metadata.to_h
|
5185
|
+
|
5186
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
5187
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
5188
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
5189
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION
|
5190
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
5191
|
+
|
5192
|
+
header_params = {}
|
5193
|
+
if request.name
|
5194
|
+
header_params["name"] = request.name
|
5195
|
+
end
|
5196
|
+
|
5197
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
5198
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
5199
|
+
|
5200
|
+
options.apply_defaults timeout: @config.rpcs.delete_backup_policy.timeout,
|
5201
|
+
metadata: metadata,
|
5202
|
+
retry_policy: @config.rpcs.delete_backup_policy.retry_policy
|
5203
|
+
|
5204
|
+
options.apply_defaults timeout: @config.timeout,
|
5205
|
+
metadata: @config.metadata,
|
5206
|
+
retry_policy: @config.retry_policy
|
5207
|
+
|
5208
|
+
@net_app_stub.call_rpc :delete_backup_policy, request, options: options do |response, operation|
|
5209
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
5210
|
+
yield response, operation if block_given?
|
5211
|
+
return response
|
5212
|
+
end
|
5213
|
+
rescue ::GRPC::BadStatus => e
|
5214
|
+
raise ::Google::Cloud::Error.from_error(e)
|
5215
|
+
end
|
5216
|
+
|
5217
|
+
##
|
5218
|
+
# Configuration class for the NetApp API.
|
5219
|
+
#
|
5220
|
+
# This class represents the configuration for NetApp,
|
5221
|
+
# providing control over timeouts, retry behavior, logging, transport
|
5222
|
+
# parameters, and other low-level controls. Certain parameters can also be
|
5223
|
+
# applied individually to specific RPCs. See
|
5224
|
+
# {::Google::Cloud::NetApp::V1::NetApp::Client::Configuration::Rpcs}
|
5225
|
+
# for a list of RPCs that can be configured independently.
|
5226
|
+
#
|
5227
|
+
# Configuration can be applied globally to all clients, or to a single client
|
5228
|
+
# on construction.
|
5229
|
+
#
|
5230
|
+
# @example
|
5231
|
+
#
|
5232
|
+
# # Modify the global config, setting the timeout for
|
5233
|
+
# # list_storage_pools to 20 seconds,
|
5234
|
+
# # and all remaining timeouts to 10 seconds.
|
5235
|
+
# ::Google::Cloud::NetApp::V1::NetApp::Client.configure do |config|
|
5236
|
+
# config.timeout = 10.0
|
5237
|
+
# config.rpcs.list_storage_pools.timeout = 20.0
|
5238
|
+
# end
|
5239
|
+
#
|
5240
|
+
# # Apply the above configuration only to a new client.
|
5241
|
+
# client = ::Google::Cloud::NetApp::V1::NetApp::Client.new do |config|
|
5242
|
+
# config.timeout = 10.0
|
5243
|
+
# config.rpcs.list_storage_pools.timeout = 20.0
|
5244
|
+
# end
|
5245
|
+
#
|
5246
|
+
# @!attribute [rw] endpoint
|
5247
|
+
# The hostname or hostname:port of the service endpoint.
|
5248
|
+
# Defaults to `"netapp.googleapis.com"`.
|
5249
|
+
# @return [::String]
|
5250
|
+
# @!attribute [rw] credentials
|
5251
|
+
# Credentials to send with calls. You may provide any of the following types:
|
5252
|
+
# * (`String`) The path to a service account key file in JSON format
|
5253
|
+
# * (`Hash`) A service account key as a Hash
|
5254
|
+
# * (`Google::Auth::Credentials`) A googleauth credentials object
|
5255
|
+
# (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
|
5256
|
+
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
5257
|
+
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
5258
|
+
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
5259
|
+
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
5260
|
+
# * (`nil`) indicating no credentials
|
5261
|
+
# @return [::Object]
|
5262
|
+
# @!attribute [rw] scope
|
5263
|
+
# The OAuth scopes
|
5264
|
+
# @return [::Array<::String>]
|
5265
|
+
# @!attribute [rw] lib_name
|
5266
|
+
# The library name as recorded in instrumentation and logging
|
5267
|
+
# @return [::String]
|
5268
|
+
# @!attribute [rw] lib_version
|
5269
|
+
# The library version as recorded in instrumentation and logging
|
5270
|
+
# @return [::String]
|
5271
|
+
# @!attribute [rw] channel_args
|
5272
|
+
# Extra parameters passed to the gRPC channel. Note: this is ignored if a
|
5273
|
+
# `GRPC::Core::Channel` object is provided as the credential.
|
5274
|
+
# @return [::Hash]
|
5275
|
+
# @!attribute [rw] interceptors
|
5276
|
+
# An array of interceptors that are run before calls are executed.
|
5277
|
+
# @return [::Array<::GRPC::ClientInterceptor>]
|
5278
|
+
# @!attribute [rw] timeout
|
5279
|
+
# The call timeout in seconds.
|
5280
|
+
# @return [::Numeric]
|
5281
|
+
# @!attribute [rw] metadata
|
5282
|
+
# Additional gRPC headers to be sent with the call.
|
5283
|
+
# @return [::Hash{::Symbol=>::String}]
|
5284
|
+
# @!attribute [rw] retry_policy
|
5285
|
+
# The retry policy. The value is a hash with the following keys:
|
5286
|
+
# * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
|
5287
|
+
# * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
|
5288
|
+
# * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
|
5289
|
+
# * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
|
5290
|
+
# trigger a retry.
|
5291
|
+
# @return [::Hash]
|
5292
|
+
# @!attribute [rw] quota_project
|
5293
|
+
# A separate project against which to charge quota.
|
5294
|
+
# @return [::String]
|
5295
|
+
#
|
5296
|
+
class Configuration
|
5297
|
+
extend ::Gapic::Config
|
5298
|
+
|
5299
|
+
DEFAULT_ENDPOINT = "netapp.googleapis.com"
|
5300
|
+
|
5301
|
+
config_attr :endpoint, DEFAULT_ENDPOINT, ::String
|
5302
|
+
config_attr :credentials, nil do |value|
|
5303
|
+
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
5304
|
+
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
5305
|
+
allowed.any? { |klass| klass === value }
|
5306
|
+
end
|
5307
|
+
config_attr :scope, nil, ::String, ::Array, nil
|
5308
|
+
config_attr :lib_name, nil, ::String, nil
|
5309
|
+
config_attr :lib_version, nil, ::String, nil
|
5310
|
+
config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
|
5311
|
+
config_attr :interceptors, nil, ::Array, nil
|
5312
|
+
config_attr :timeout, nil, ::Numeric, nil
|
5313
|
+
config_attr :metadata, nil, ::Hash, nil
|
5314
|
+
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
5315
|
+
config_attr :quota_project, nil, ::String, nil
|
5316
|
+
|
5317
|
+
# @private
|
5318
|
+
def initialize parent_config = nil
|
5319
|
+
@parent_config = parent_config unless parent_config.nil?
|
5320
|
+
|
5321
|
+
yield self if block_given?
|
5322
|
+
end
|
5323
|
+
|
5324
|
+
##
|
5325
|
+
# Configurations for individual RPCs
|
5326
|
+
# @return [Rpcs]
|
5327
|
+
#
|
5328
|
+
def rpcs
|
5329
|
+
@rpcs ||= begin
|
5330
|
+
parent_rpcs = nil
|
5331
|
+
parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
|
5332
|
+
Rpcs.new parent_rpcs
|
5333
|
+
end
|
5334
|
+
end
|
5335
|
+
|
5336
|
+
##
|
5337
|
+
# Configuration for the channel pool
|
5338
|
+
# @return [::Gapic::ServiceStub::ChannelPool::Configuration]
|
5339
|
+
#
|
5340
|
+
def channel_pool
|
5341
|
+
@channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
|
5342
|
+
end
|
5343
|
+
|
5344
|
+
##
|
5345
|
+
# Configuration RPC class for the NetApp API.
|
5346
|
+
#
|
5347
|
+
# Includes fields providing the configuration for each RPC in this service.
|
5348
|
+
# Each configuration object is of type `Gapic::Config::Method` and includes
|
5349
|
+
# the following configuration fields:
|
5350
|
+
#
|
5351
|
+
# * `timeout` (*type:* `Numeric`) - The call timeout in seconds
|
5352
|
+
# * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
|
5353
|
+
# * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
|
5354
|
+
# include the following keys:
|
3847
5355
|
# * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
|
3848
5356
|
# * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
|
3849
5357
|
# * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
|
@@ -4031,6 +5539,81 @@ module Google
|
|
4031
5539
|
# @return [::Gapic::Config::Method]
|
4032
5540
|
#
|
4033
5541
|
attr_reader :reverse_replication_direction
|
5542
|
+
##
|
5543
|
+
# RPC-specific configuration for `create_backup_vault`
|
5544
|
+
# @return [::Gapic::Config::Method]
|
5545
|
+
#
|
5546
|
+
attr_reader :create_backup_vault
|
5547
|
+
##
|
5548
|
+
# RPC-specific configuration for `get_backup_vault`
|
5549
|
+
# @return [::Gapic::Config::Method]
|
5550
|
+
#
|
5551
|
+
attr_reader :get_backup_vault
|
5552
|
+
##
|
5553
|
+
# RPC-specific configuration for `list_backup_vaults`
|
5554
|
+
# @return [::Gapic::Config::Method]
|
5555
|
+
#
|
5556
|
+
attr_reader :list_backup_vaults
|
5557
|
+
##
|
5558
|
+
# RPC-specific configuration for `update_backup_vault`
|
5559
|
+
# @return [::Gapic::Config::Method]
|
5560
|
+
#
|
5561
|
+
attr_reader :update_backup_vault
|
5562
|
+
##
|
5563
|
+
# RPC-specific configuration for `delete_backup_vault`
|
5564
|
+
# @return [::Gapic::Config::Method]
|
5565
|
+
#
|
5566
|
+
attr_reader :delete_backup_vault
|
5567
|
+
##
|
5568
|
+
# RPC-specific configuration for `create_backup`
|
5569
|
+
# @return [::Gapic::Config::Method]
|
5570
|
+
#
|
5571
|
+
attr_reader :create_backup
|
5572
|
+
##
|
5573
|
+
# RPC-specific configuration for `get_backup`
|
5574
|
+
# @return [::Gapic::Config::Method]
|
5575
|
+
#
|
5576
|
+
attr_reader :get_backup
|
5577
|
+
##
|
5578
|
+
# RPC-specific configuration for `list_backups`
|
5579
|
+
# @return [::Gapic::Config::Method]
|
5580
|
+
#
|
5581
|
+
attr_reader :list_backups
|
5582
|
+
##
|
5583
|
+
# RPC-specific configuration for `delete_backup`
|
5584
|
+
# @return [::Gapic::Config::Method]
|
5585
|
+
#
|
5586
|
+
attr_reader :delete_backup
|
5587
|
+
##
|
5588
|
+
# RPC-specific configuration for `update_backup`
|
5589
|
+
# @return [::Gapic::Config::Method]
|
5590
|
+
#
|
5591
|
+
attr_reader :update_backup
|
5592
|
+
##
|
5593
|
+
# RPC-specific configuration for `create_backup_policy`
|
5594
|
+
# @return [::Gapic::Config::Method]
|
5595
|
+
#
|
5596
|
+
attr_reader :create_backup_policy
|
5597
|
+
##
|
5598
|
+
# RPC-specific configuration for `get_backup_policy`
|
5599
|
+
# @return [::Gapic::Config::Method]
|
5600
|
+
#
|
5601
|
+
attr_reader :get_backup_policy
|
5602
|
+
##
|
5603
|
+
# RPC-specific configuration for `list_backup_policies`
|
5604
|
+
# @return [::Gapic::Config::Method]
|
5605
|
+
#
|
5606
|
+
attr_reader :list_backup_policies
|
5607
|
+
##
|
5608
|
+
# RPC-specific configuration for `update_backup_policy`
|
5609
|
+
# @return [::Gapic::Config::Method]
|
5610
|
+
#
|
5611
|
+
attr_reader :update_backup_policy
|
5612
|
+
##
|
5613
|
+
# RPC-specific configuration for `delete_backup_policy`
|
5614
|
+
# @return [::Gapic::Config::Method]
|
5615
|
+
#
|
5616
|
+
attr_reader :delete_backup_policy
|
4034
5617
|
|
4035
5618
|
# @private
|
4036
5619
|
def initialize parent_rpcs = nil
|
@@ -4106,6 +5689,36 @@ module Google
|
|
4106
5689
|
@resume_replication = ::Gapic::Config::Method.new resume_replication_config
|
4107
5690
|
reverse_replication_direction_config = parent_rpcs.reverse_replication_direction if parent_rpcs.respond_to? :reverse_replication_direction
|
4108
5691
|
@reverse_replication_direction = ::Gapic::Config::Method.new reverse_replication_direction_config
|
5692
|
+
create_backup_vault_config = parent_rpcs.create_backup_vault if parent_rpcs.respond_to? :create_backup_vault
|
5693
|
+
@create_backup_vault = ::Gapic::Config::Method.new create_backup_vault_config
|
5694
|
+
get_backup_vault_config = parent_rpcs.get_backup_vault if parent_rpcs.respond_to? :get_backup_vault
|
5695
|
+
@get_backup_vault = ::Gapic::Config::Method.new get_backup_vault_config
|
5696
|
+
list_backup_vaults_config = parent_rpcs.list_backup_vaults if parent_rpcs.respond_to? :list_backup_vaults
|
5697
|
+
@list_backup_vaults = ::Gapic::Config::Method.new list_backup_vaults_config
|
5698
|
+
update_backup_vault_config = parent_rpcs.update_backup_vault if parent_rpcs.respond_to? :update_backup_vault
|
5699
|
+
@update_backup_vault = ::Gapic::Config::Method.new update_backup_vault_config
|
5700
|
+
delete_backup_vault_config = parent_rpcs.delete_backup_vault if parent_rpcs.respond_to? :delete_backup_vault
|
5701
|
+
@delete_backup_vault = ::Gapic::Config::Method.new delete_backup_vault_config
|
5702
|
+
create_backup_config = parent_rpcs.create_backup if parent_rpcs.respond_to? :create_backup
|
5703
|
+
@create_backup = ::Gapic::Config::Method.new create_backup_config
|
5704
|
+
get_backup_config = parent_rpcs.get_backup if parent_rpcs.respond_to? :get_backup
|
5705
|
+
@get_backup = ::Gapic::Config::Method.new get_backup_config
|
5706
|
+
list_backups_config = parent_rpcs.list_backups if parent_rpcs.respond_to? :list_backups
|
5707
|
+
@list_backups = ::Gapic::Config::Method.new list_backups_config
|
5708
|
+
delete_backup_config = parent_rpcs.delete_backup if parent_rpcs.respond_to? :delete_backup
|
5709
|
+
@delete_backup = ::Gapic::Config::Method.new delete_backup_config
|
5710
|
+
update_backup_config = parent_rpcs.update_backup if parent_rpcs.respond_to? :update_backup
|
5711
|
+
@update_backup = ::Gapic::Config::Method.new update_backup_config
|
5712
|
+
create_backup_policy_config = parent_rpcs.create_backup_policy if parent_rpcs.respond_to? :create_backup_policy
|
5713
|
+
@create_backup_policy = ::Gapic::Config::Method.new create_backup_policy_config
|
5714
|
+
get_backup_policy_config = parent_rpcs.get_backup_policy if parent_rpcs.respond_to? :get_backup_policy
|
5715
|
+
@get_backup_policy = ::Gapic::Config::Method.new get_backup_policy_config
|
5716
|
+
list_backup_policies_config = parent_rpcs.list_backup_policies if parent_rpcs.respond_to? :list_backup_policies
|
5717
|
+
@list_backup_policies = ::Gapic::Config::Method.new list_backup_policies_config
|
5718
|
+
update_backup_policy_config = parent_rpcs.update_backup_policy if parent_rpcs.respond_to? :update_backup_policy
|
5719
|
+
@update_backup_policy = ::Gapic::Config::Method.new update_backup_policy_config
|
5720
|
+
delete_backup_policy_config = parent_rpcs.delete_backup_policy if parent_rpcs.respond_to? :delete_backup_policy
|
5721
|
+
@delete_backup_policy = ::Gapic::Config::Method.new delete_backup_policy_config
|
4109
5722
|
|
4110
5723
|
yield self if block_given?
|
4111
5724
|
end
|