google-cloud-netapp-v1 2.12.2 → 2.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/google/cloud/netapp/v1/backup_pb.rb +2 -1
- data/lib/google/cloud/netapp/v1/backup_vault_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/cloud_netapp_service_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/cloud_netapp_service_services_pb.rb +19 -4
- data/lib/google/cloud/netapp/v1/common_pb.rb +2 -1
- data/lib/google/cloud/netapp/v1/kms_pb.rb +1 -1
- data/lib/google/cloud/netapp/v1/netapp/client.rb +534 -6
- data/lib/google/cloud/netapp/v1/netapp/paths.rb +21 -0
- data/lib/google/cloud/netapp/v1/netapp/rest/client.rb +499 -6
- data/lib/google/cloud/netapp/v1/netapp/rest/service_stub.rb +308 -0
- data/lib/google/cloud/netapp/v1/version.rb +1 -1
- data/lib/google/cloud/netapp/v1/volume_pb.rb +14 -1
- data/proto_docs/google/cloud/netapp/v1/backup.rb +24 -4
- data/proto_docs/google/cloud/netapp/v1/backup_vault.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/common.rb +12 -0
- data/proto_docs/google/cloud/netapp/v1/kms.rb +1 -1
- data/proto_docs/google/cloud/netapp/v1/ontap.rb +1 -1
- data/proto_docs/google/cloud/netapp/v1/storage_pool.rb +2 -2
- data/proto_docs/google/cloud/netapp/v1/volume.rb +199 -4
- metadata +1 -1
|
@@ -1530,6 +1530,178 @@ module Google
|
|
|
1530
1530
|
raise ::Google::Cloud::Error.from_error(e)
|
|
1531
1531
|
end
|
|
1532
1532
|
|
|
1533
|
+
##
|
|
1534
|
+
# Splits a clone volume from its source volume.
|
|
1535
|
+
# This operation will only work for volumes which have clone_details
|
|
1536
|
+
# set(clones).
|
|
1537
|
+
# For volumes that are not clones, this operation will return an error.
|
|
1538
|
+
#
|
|
1539
|
+
# @overload start_split(request, options = nil)
|
|
1540
|
+
# Pass arguments to `start_split` via a request object, either of type
|
|
1541
|
+
# {::Google::Cloud::NetApp::V1::StartSplitRequest} or an equivalent Hash.
|
|
1542
|
+
#
|
|
1543
|
+
# @param request [::Google::Cloud::NetApp::V1::StartSplitRequest, ::Hash]
|
|
1544
|
+
# A request object representing the call parameters. Required. To specify no
|
|
1545
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
|
1546
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
|
1547
|
+
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
1548
|
+
#
|
|
1549
|
+
# @overload start_split(name: nil)
|
|
1550
|
+
# Pass arguments to `start_split` via keyword arguments. Note that at
|
|
1551
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
1552
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
1553
|
+
#
|
|
1554
|
+
# @param name [::String]
|
|
1555
|
+
# Required. The full name of the clone volume to be split from its source.
|
|
1556
|
+
# Format: projects/\\{project_number}/locations/\\{location}/volumes/\\{volume_id}
|
|
1557
|
+
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
1558
|
+
# @yieldparam result [::Gapic::Operation]
|
|
1559
|
+
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
1560
|
+
#
|
|
1561
|
+
# @return [::Gapic::Operation]
|
|
1562
|
+
#
|
|
1563
|
+
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1564
|
+
#
|
|
1565
|
+
# @example Basic example
|
|
1566
|
+
# require "google/cloud/netapp/v1"
|
|
1567
|
+
#
|
|
1568
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1569
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
|
|
1570
|
+
#
|
|
1571
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1572
|
+
# request = Google::Cloud::NetApp::V1::StartSplitRequest.new
|
|
1573
|
+
#
|
|
1574
|
+
# # Call the start_split method.
|
|
1575
|
+
# result = client.start_split request
|
|
1576
|
+
#
|
|
1577
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
|
1578
|
+
# # check the status of an operation, cancel it, or wait for results.
|
|
1579
|
+
# # Here is how to wait for a response.
|
|
1580
|
+
# result.wait_until_done! timeout: 60
|
|
1581
|
+
# if result.response?
|
|
1582
|
+
# p result.response
|
|
1583
|
+
# else
|
|
1584
|
+
# puts "No response received."
|
|
1585
|
+
# end
|
|
1586
|
+
#
|
|
1587
|
+
def start_split request, options = nil
|
|
1588
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1589
|
+
|
|
1590
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::StartSplitRequest
|
|
1591
|
+
|
|
1592
|
+
# Converts hash and nil to an options object
|
|
1593
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
|
1594
|
+
|
|
1595
|
+
# Customize the options with defaults
|
|
1596
|
+
call_metadata = @config.rpcs.start_split.metadata.to_h
|
|
1597
|
+
|
|
1598
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
1599
|
+
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
1600
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
1601
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
|
|
1602
|
+
transports_version_send: [:rest]
|
|
1603
|
+
|
|
1604
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
1605
|
+
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
1606
|
+
|
|
1607
|
+
options.apply_defaults timeout: @config.rpcs.start_split.timeout,
|
|
1608
|
+
metadata: call_metadata,
|
|
1609
|
+
retry_policy: @config.rpcs.start_split.retry_policy
|
|
1610
|
+
|
|
1611
|
+
options.apply_defaults timeout: @config.timeout,
|
|
1612
|
+
metadata: @config.metadata,
|
|
1613
|
+
retry_policy: @config.retry_policy
|
|
1614
|
+
|
|
1615
|
+
@net_app_stub.start_split request, options do |result, operation|
|
|
1616
|
+
result = ::Gapic::Operation.new result, @operations_client, options: options
|
|
1617
|
+
yield result, operation if block_given?
|
|
1618
|
+
throw :response, result
|
|
1619
|
+
end
|
|
1620
|
+
rescue ::Gapic::Rest::Error => e
|
|
1621
|
+
raise ::Google::Cloud::Error.from_error(e)
|
|
1622
|
+
end
|
|
1623
|
+
|
|
1624
|
+
##
|
|
1625
|
+
# Retrieves the current state, progress, and details of a split operation for
|
|
1626
|
+
# a volume. This method is relevant when the volume is a clone. For volumes
|
|
1627
|
+
# that are not clones, this method will return an error.
|
|
1628
|
+
#
|
|
1629
|
+
# @overload get_split_status(request, options = nil)
|
|
1630
|
+
# Pass arguments to `get_split_status` via a request object, either of type
|
|
1631
|
+
# {::Google::Cloud::NetApp::V1::GetSplitStatusRequest} or an equivalent Hash.
|
|
1632
|
+
#
|
|
1633
|
+
# @param request [::Google::Cloud::NetApp::V1::GetSplitStatusRequest, ::Hash]
|
|
1634
|
+
# A request object representing the call parameters. Required. To specify no
|
|
1635
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
|
1636
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
|
1637
|
+
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
1638
|
+
#
|
|
1639
|
+
# @overload get_split_status(name: nil)
|
|
1640
|
+
# Pass arguments to `get_split_status` via keyword arguments. Note that at
|
|
1641
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
1642
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
1643
|
+
#
|
|
1644
|
+
# @param name [::String]
|
|
1645
|
+
# Required. The full name of the volume.
|
|
1646
|
+
# Format: projects/\\{project_number}/locations/\\{location}/volumes/\\{volume_id}
|
|
1647
|
+
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
1648
|
+
# @yieldparam result [::Google::Cloud::NetApp::V1::SplitStatus]
|
|
1649
|
+
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
1650
|
+
#
|
|
1651
|
+
# @return [::Google::Cloud::NetApp::V1::SplitStatus]
|
|
1652
|
+
#
|
|
1653
|
+
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
1654
|
+
#
|
|
1655
|
+
# @example Basic example
|
|
1656
|
+
# require "google/cloud/netapp/v1"
|
|
1657
|
+
#
|
|
1658
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
1659
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
|
|
1660
|
+
#
|
|
1661
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
1662
|
+
# request = Google::Cloud::NetApp::V1::GetSplitStatusRequest.new
|
|
1663
|
+
#
|
|
1664
|
+
# # Call the get_split_status method.
|
|
1665
|
+
# result = client.get_split_status request
|
|
1666
|
+
#
|
|
1667
|
+
# # The returned object is of type Google::Cloud::NetApp::V1::SplitStatus.
|
|
1668
|
+
# p result
|
|
1669
|
+
#
|
|
1670
|
+
def get_split_status request, options = nil
|
|
1671
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
1672
|
+
|
|
1673
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::GetSplitStatusRequest
|
|
1674
|
+
|
|
1675
|
+
# Converts hash and nil to an options object
|
|
1676
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
|
1677
|
+
|
|
1678
|
+
# Customize the options with defaults
|
|
1679
|
+
call_metadata = @config.rpcs.get_split_status.metadata.to_h
|
|
1680
|
+
|
|
1681
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
1682
|
+
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
1683
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
1684
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
|
|
1685
|
+
transports_version_send: [:rest]
|
|
1686
|
+
|
|
1687
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
1688
|
+
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
1689
|
+
|
|
1690
|
+
options.apply_defaults timeout: @config.rpcs.get_split_status.timeout,
|
|
1691
|
+
metadata: call_metadata,
|
|
1692
|
+
retry_policy: @config.rpcs.get_split_status.retry_policy
|
|
1693
|
+
|
|
1694
|
+
options.apply_defaults timeout: @config.timeout,
|
|
1695
|
+
metadata: @config.metadata,
|
|
1696
|
+
retry_policy: @config.retry_policy
|
|
1697
|
+
|
|
1698
|
+
@net_app_stub.get_split_status request, options do |result, operation|
|
|
1699
|
+
yield result, operation if block_given?
|
|
1700
|
+
end
|
|
1701
|
+
rescue ::Gapic::Rest::Error => e
|
|
1702
|
+
raise ::Google::Cloud::Error.from_error(e)
|
|
1703
|
+
end
|
|
1704
|
+
|
|
1533
1705
|
##
|
|
1534
1706
|
# Establish volume peering. This is used to establish cluster and svm
|
|
1535
1707
|
# peerings between the GCNV and OnPrem clusters.
|
|
@@ -1559,7 +1731,7 @@ module Google
|
|
|
1559
1731
|
# Required. Name of the user's local source vserver svm to be peered with the
|
|
1560
1732
|
# destination vserver svm.
|
|
1561
1733
|
# @param peer_ip_addresses [::Array<::String>]
|
|
1562
|
-
# Optional. List of IPv4
|
|
1734
|
+
# Optional. List of IPv4 IP addresses to be used for peering.
|
|
1563
1735
|
# @param peer_volume_name [::String]
|
|
1564
1736
|
# Required. Name of the user's local source volume to be peered with the
|
|
1565
1737
|
# destination volume.
|
|
@@ -6398,7 +6570,7 @@ module Google
|
|
|
6398
6570
|
end
|
|
6399
6571
|
|
|
6400
6572
|
##
|
|
6401
|
-
# `ExecuteOntapPost`
|
|
6573
|
+
# `ExecuteOntapPost` sends the ONTAP `POST` request to the
|
|
6402
6574
|
# `StoragePool` cluster.
|
|
6403
6575
|
#
|
|
6404
6576
|
# @overload execute_ontap_post(request, options = nil)
|
|
@@ -6429,7 +6601,7 @@ module Google
|
|
|
6429
6601
|
# }
|
|
6430
6602
|
# ```
|
|
6431
6603
|
# @param ontap_path [::String]
|
|
6432
|
-
# Required. The
|
|
6604
|
+
# Required. The path of the ONTAP resource.
|
|
6433
6605
|
# Format:
|
|
6434
6606
|
# `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`.
|
|
6435
6607
|
# For example:
|
|
@@ -6493,7 +6665,7 @@ module Google
|
|
|
6493
6665
|
end
|
|
6494
6666
|
|
|
6495
6667
|
##
|
|
6496
|
-
# `ExecuteOntapGet`
|
|
6668
|
+
# `ExecuteOntapGet` sends the ONTAP `GET` request to the
|
|
6497
6669
|
# `StoragePool` cluster.
|
|
6498
6670
|
#
|
|
6499
6671
|
# @overload execute_ontap_get(request, options = nil)
|
|
@@ -6576,7 +6748,7 @@ module Google
|
|
|
6576
6748
|
end
|
|
6577
6749
|
|
|
6578
6750
|
##
|
|
6579
|
-
# `ExecuteOntapDelete`
|
|
6751
|
+
# `ExecuteOntapDelete` sends the ONTAP `DELETE` request to the
|
|
6580
6752
|
# `StoragePool` cluster.
|
|
6581
6753
|
#
|
|
6582
6754
|
# @overload execute_ontap_delete(request, options = nil)
|
|
@@ -6659,7 +6831,7 @@ module Google
|
|
|
6659
6831
|
end
|
|
6660
6832
|
|
|
6661
6833
|
##
|
|
6662
|
-
# `ExecuteOntapPatch`
|
|
6834
|
+
# `ExecuteOntapPatch` sends the ONTAP `PATCH` request to the
|
|
6663
6835
|
# `StoragePool` cluster.
|
|
6664
6836
|
#
|
|
6665
6837
|
# @overload execute_ontap_patch(request, options = nil)
|
|
@@ -6753,6 +6925,292 @@ module Google
|
|
|
6753
6925
|
raise ::Google::Cloud::Error.from_error(e)
|
|
6754
6926
|
end
|
|
6755
6927
|
|
|
6928
|
+
##
|
|
6929
|
+
# Restores a backup to an ONTAP-mode volume.
|
|
6930
|
+
#
|
|
6931
|
+
# @overload restore_volume(request, options = nil)
|
|
6932
|
+
# Pass arguments to `restore_volume` via a request object, either of type
|
|
6933
|
+
# {::Google::Cloud::NetApp::V1::RestoreVolumeRequest} or an equivalent Hash.
|
|
6934
|
+
#
|
|
6935
|
+
# @param request [::Google::Cloud::NetApp::V1::RestoreVolumeRequest, ::Hash]
|
|
6936
|
+
# A request object representing the call parameters. Required. To specify no
|
|
6937
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
|
6938
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
|
6939
|
+
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
6940
|
+
#
|
|
6941
|
+
# @overload restore_volume(backup_source: nil, ontap_volume_target: nil, name: nil)
|
|
6942
|
+
# Pass arguments to `restore_volume` via keyword arguments. Note that at
|
|
6943
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
6944
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
6945
|
+
#
|
|
6946
|
+
# @param backup_source [::Google::Cloud::NetApp::V1::BackupSource, ::Hash]
|
|
6947
|
+
# The backup source of the restore operation.
|
|
6948
|
+
# @param ontap_volume_target [::Google::Cloud::NetApp::V1::OntapVolumeTarget, ::Hash]
|
|
6949
|
+
# The ONTAP volume target of the restore operation.
|
|
6950
|
+
# @param name [::String]
|
|
6951
|
+
# Required. The resource name of the ONTAP mode storage pool, in the format
|
|
6952
|
+
# of `projects/{project}/locations/{location}/storagePools/{storage_pool}`
|
|
6953
|
+
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
6954
|
+
# @yieldparam result [::Gapic::Operation]
|
|
6955
|
+
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
6956
|
+
#
|
|
6957
|
+
# @return [::Gapic::Operation]
|
|
6958
|
+
#
|
|
6959
|
+
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
6960
|
+
#
|
|
6961
|
+
# @example Basic example
|
|
6962
|
+
# require "google/cloud/netapp/v1"
|
|
6963
|
+
#
|
|
6964
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
6965
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
|
|
6966
|
+
#
|
|
6967
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
6968
|
+
# request = Google::Cloud::NetApp::V1::RestoreVolumeRequest.new
|
|
6969
|
+
#
|
|
6970
|
+
# # Call the restore_volume method.
|
|
6971
|
+
# result = client.restore_volume request
|
|
6972
|
+
#
|
|
6973
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
|
6974
|
+
# # check the status of an operation, cancel it, or wait for results.
|
|
6975
|
+
# # Here is how to wait for a response.
|
|
6976
|
+
# result.wait_until_done! timeout: 60
|
|
6977
|
+
# if result.response?
|
|
6978
|
+
# p result.response
|
|
6979
|
+
# else
|
|
6980
|
+
# puts "No response received."
|
|
6981
|
+
# end
|
|
6982
|
+
#
|
|
6983
|
+
def restore_volume request, options = nil
|
|
6984
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
6985
|
+
|
|
6986
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::RestoreVolumeRequest
|
|
6987
|
+
|
|
6988
|
+
# Converts hash and nil to an options object
|
|
6989
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
|
6990
|
+
|
|
6991
|
+
# Customize the options with defaults
|
|
6992
|
+
call_metadata = @config.rpcs.restore_volume.metadata.to_h
|
|
6993
|
+
|
|
6994
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
6995
|
+
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
6996
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
6997
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
|
|
6998
|
+
transports_version_send: [:rest]
|
|
6999
|
+
|
|
7000
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
7001
|
+
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
7002
|
+
|
|
7003
|
+
options.apply_defaults timeout: @config.rpcs.restore_volume.timeout,
|
|
7004
|
+
metadata: call_metadata,
|
|
7005
|
+
retry_policy: @config.rpcs.restore_volume.retry_policy
|
|
7006
|
+
|
|
7007
|
+
options.apply_defaults timeout: @config.timeout,
|
|
7008
|
+
metadata: @config.metadata,
|
|
7009
|
+
retry_policy: @config.retry_policy
|
|
7010
|
+
|
|
7011
|
+
@net_app_stub.restore_volume request, options do |result, operation|
|
|
7012
|
+
result = ::Gapic::Operation.new result, @operations_client, options: options
|
|
7013
|
+
yield result, operation if block_given?
|
|
7014
|
+
throw :response, result
|
|
7015
|
+
end
|
|
7016
|
+
rescue ::Gapic::Rest::Error => e
|
|
7017
|
+
raise ::Google::Cloud::Error.from_error(e)
|
|
7018
|
+
end
|
|
7019
|
+
|
|
7020
|
+
##
|
|
7021
|
+
# Lists backup configurations for all volumes in an ONTAP-mode Storage Pool.
|
|
7022
|
+
#
|
|
7023
|
+
# @overload list_backup_configs(request, options = nil)
|
|
7024
|
+
# Pass arguments to `list_backup_configs` via a request object, either of type
|
|
7025
|
+
# {::Google::Cloud::NetApp::V1::ListBackupConfigsRequest} or an equivalent Hash.
|
|
7026
|
+
#
|
|
7027
|
+
# @param request [::Google::Cloud::NetApp::V1::ListBackupConfigsRequest, ::Hash]
|
|
7028
|
+
# A request object representing the call parameters. Required. To specify no
|
|
7029
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
|
7030
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
|
7031
|
+
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
7032
|
+
#
|
|
7033
|
+
# @overload list_backup_configs(parent: nil, page_size: nil, page_token: nil, order_by: nil, filter: nil)
|
|
7034
|
+
# Pass arguments to `list_backup_configs` via keyword arguments. Note that at
|
|
7035
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
7036
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
7037
|
+
#
|
|
7038
|
+
# @param parent [::String]
|
|
7039
|
+
# Required. The ONTAP StoragePool for which to retrieve backup configuration
|
|
7040
|
+
# information, in the format
|
|
7041
|
+
# `projects/{project}/locations/{location}/storagePools/{storage_pool}`.
|
|
7042
|
+
# @param page_size [::Integer]
|
|
7043
|
+
# Optional. The maximum number of items to return. The service may return
|
|
7044
|
+
# fewer than this value. The maximum value is 1000; values above 1000 will be
|
|
7045
|
+
# coerced to 1000. If unspecified or set to 0, a default of 50 will be used.
|
|
7046
|
+
# @param page_token [::String]
|
|
7047
|
+
# Optional. The next_page_token value to use if there are additional
|
|
7048
|
+
# results to retrieve for this list request.
|
|
7049
|
+
# @param order_by [::String]
|
|
7050
|
+
# Optional. Sort results. Supported values are "volume_id" or ""
|
|
7051
|
+
# @param filter [::String]
|
|
7052
|
+
# Optional. The standard list filter.
|
|
7053
|
+
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
7054
|
+
# @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetApp::V1::VolumeBackupConfig>]
|
|
7055
|
+
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
7056
|
+
#
|
|
7057
|
+
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::NetApp::V1::VolumeBackupConfig>]
|
|
7058
|
+
#
|
|
7059
|
+
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
7060
|
+
#
|
|
7061
|
+
# @example Basic example
|
|
7062
|
+
# require "google/cloud/netapp/v1"
|
|
7063
|
+
#
|
|
7064
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
7065
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
|
|
7066
|
+
#
|
|
7067
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
7068
|
+
# request = Google::Cloud::NetApp::V1::ListBackupConfigsRequest.new
|
|
7069
|
+
#
|
|
7070
|
+
# # Call the list_backup_configs method.
|
|
7071
|
+
# result = client.list_backup_configs request
|
|
7072
|
+
#
|
|
7073
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
|
7074
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
|
7075
|
+
# result.each do |item|
|
|
7076
|
+
# # Each element is of type ::Google::Cloud::NetApp::V1::VolumeBackupConfig.
|
|
7077
|
+
# p item
|
|
7078
|
+
# end
|
|
7079
|
+
#
|
|
7080
|
+
def list_backup_configs request, options = nil
|
|
7081
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
7082
|
+
|
|
7083
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::ListBackupConfigsRequest
|
|
7084
|
+
|
|
7085
|
+
# Converts hash and nil to an options object
|
|
7086
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
|
7087
|
+
|
|
7088
|
+
# Customize the options with defaults
|
|
7089
|
+
call_metadata = @config.rpcs.list_backup_configs.metadata.to_h
|
|
7090
|
+
|
|
7091
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
7092
|
+
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
7093
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
7094
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
|
|
7095
|
+
transports_version_send: [:rest]
|
|
7096
|
+
|
|
7097
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
7098
|
+
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
7099
|
+
|
|
7100
|
+
options.apply_defaults timeout: @config.rpcs.list_backup_configs.timeout,
|
|
7101
|
+
metadata: call_metadata,
|
|
7102
|
+
retry_policy: @config.rpcs.list_backup_configs.retry_policy
|
|
7103
|
+
|
|
7104
|
+
options.apply_defaults timeout: @config.timeout,
|
|
7105
|
+
metadata: @config.metadata,
|
|
7106
|
+
retry_policy: @config.retry_policy
|
|
7107
|
+
|
|
7108
|
+
@net_app_stub.list_backup_configs request, options do |result, operation|
|
|
7109
|
+
result = ::Gapic::Rest::PagedEnumerable.new @net_app_stub, :list_backup_configs, "volume_backup_configs", request, result, options
|
|
7110
|
+
yield result, operation if block_given?
|
|
7111
|
+
throw :response, result
|
|
7112
|
+
end
|
|
7113
|
+
rescue ::Gapic::Rest::Error => e
|
|
7114
|
+
raise ::Google::Cloud::Error.from_error(e)
|
|
7115
|
+
end
|
|
7116
|
+
|
|
7117
|
+
##
|
|
7118
|
+
# Updates the backup configuration for an ONTAP-mode volume.
|
|
7119
|
+
#
|
|
7120
|
+
# @overload update_backup_config(request, options = nil)
|
|
7121
|
+
# Pass arguments to `update_backup_config` via a request object, either of type
|
|
7122
|
+
# {::Google::Cloud::NetApp::V1::UpdateBackupConfigRequest} or an equivalent Hash.
|
|
7123
|
+
#
|
|
7124
|
+
# @param request [::Google::Cloud::NetApp::V1::UpdateBackupConfigRequest, ::Hash]
|
|
7125
|
+
# A request object representing the call parameters. Required. To specify no
|
|
7126
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
|
7127
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
|
7128
|
+
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
|
7129
|
+
#
|
|
7130
|
+
# @overload update_backup_config(name: nil, volume_uuid: nil, backup_config: nil, update_mask: nil)
|
|
7131
|
+
# Pass arguments to `update_backup_config` via keyword arguments. Note that at
|
|
7132
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
|
7133
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
|
7134
|
+
#
|
|
7135
|
+
# @param name [::String]
|
|
7136
|
+
# Required. The resource name of the StoragePool, in the format:
|
|
7137
|
+
# projects/\\{projectNumber}/locations/\\{locationId}/storagePools/\\{poolId}
|
|
7138
|
+
# @param volume_uuid [::String]
|
|
7139
|
+
# Required. The UUID of the ONTAP-mode volume.
|
|
7140
|
+
# @param backup_config [::Google::Cloud::NetApp::V1::BackupConfig, ::Hash]
|
|
7141
|
+
# Required. Backup configuration to apply.
|
|
7142
|
+
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
|
7143
|
+
# Required. Field mask is used to specify the fields to be overwritten in the
|
|
7144
|
+
# BackupConfig for the Volume.
|
|
7145
|
+
# The fields specified in the update_mask are relative to the resource, not
|
|
7146
|
+
# the full request. A field will be overwritten if it is in the mask.
|
|
7147
|
+
# @yield [result, operation] Access the result along with the TransportOperation object
|
|
7148
|
+
# @yieldparam result [::Gapic::Operation]
|
|
7149
|
+
# @yieldparam operation [::Gapic::Rest::TransportOperation]
|
|
7150
|
+
#
|
|
7151
|
+
# @return [::Gapic::Operation]
|
|
7152
|
+
#
|
|
7153
|
+
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
|
7154
|
+
#
|
|
7155
|
+
# @example Basic example
|
|
7156
|
+
# require "google/cloud/netapp/v1"
|
|
7157
|
+
#
|
|
7158
|
+
# # Create a client object. The client can be reused for multiple calls.
|
|
7159
|
+
# client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
|
|
7160
|
+
#
|
|
7161
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
|
7162
|
+
# request = Google::Cloud::NetApp::V1::UpdateBackupConfigRequest.new
|
|
7163
|
+
#
|
|
7164
|
+
# # Call the update_backup_config method.
|
|
7165
|
+
# result = client.update_backup_config request
|
|
7166
|
+
#
|
|
7167
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
|
7168
|
+
# # check the status of an operation, cancel it, or wait for results.
|
|
7169
|
+
# # Here is how to wait for a response.
|
|
7170
|
+
# result.wait_until_done! timeout: 60
|
|
7171
|
+
# if result.response?
|
|
7172
|
+
# p result.response
|
|
7173
|
+
# else
|
|
7174
|
+
# puts "No response received."
|
|
7175
|
+
# end
|
|
7176
|
+
#
|
|
7177
|
+
def update_backup_config request, options = nil
|
|
7178
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
|
7179
|
+
|
|
7180
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::UpdateBackupConfigRequest
|
|
7181
|
+
|
|
7182
|
+
# Converts hash and nil to an options object
|
|
7183
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
|
7184
|
+
|
|
7185
|
+
# Customize the options with defaults
|
|
7186
|
+
call_metadata = @config.rpcs.update_backup_config.metadata.to_h
|
|
7187
|
+
|
|
7188
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
7189
|
+
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
7190
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
7191
|
+
gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
|
|
7192
|
+
transports_version_send: [:rest]
|
|
7193
|
+
|
|
7194
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
7195
|
+
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
7196
|
+
|
|
7197
|
+
options.apply_defaults timeout: @config.rpcs.update_backup_config.timeout,
|
|
7198
|
+
metadata: call_metadata,
|
|
7199
|
+
retry_policy: @config.rpcs.update_backup_config.retry_policy
|
|
7200
|
+
|
|
7201
|
+
options.apply_defaults timeout: @config.timeout,
|
|
7202
|
+
metadata: @config.metadata,
|
|
7203
|
+
retry_policy: @config.retry_policy
|
|
7204
|
+
|
|
7205
|
+
@net_app_stub.update_backup_config request, options do |result, operation|
|
|
7206
|
+
result = ::Gapic::Operation.new result, @operations_client, options: options
|
|
7207
|
+
yield result, operation if block_given?
|
|
7208
|
+
throw :response, result
|
|
7209
|
+
end
|
|
7210
|
+
rescue ::Gapic::Rest::Error => e
|
|
7211
|
+
raise ::Google::Cloud::Error.from_error(e)
|
|
7212
|
+
end
|
|
7213
|
+
|
|
6756
7214
|
##
|
|
6757
7215
|
# Configuration class for the NetApp REST API.
|
|
6758
7216
|
#
|
|
@@ -6974,6 +7432,16 @@ module Google
|
|
|
6974
7432
|
#
|
|
6975
7433
|
attr_reader :revert_volume
|
|
6976
7434
|
##
|
|
7435
|
+
# RPC-specific configuration for `start_split`
|
|
7436
|
+
# @return [::Gapic::Config::Method]
|
|
7437
|
+
#
|
|
7438
|
+
attr_reader :start_split
|
|
7439
|
+
##
|
|
7440
|
+
# RPC-specific configuration for `get_split_status`
|
|
7441
|
+
# @return [::Gapic::Config::Method]
|
|
7442
|
+
#
|
|
7443
|
+
attr_reader :get_split_status
|
|
7444
|
+
##
|
|
6977
7445
|
# RPC-specific configuration for `establish_volume_peering`
|
|
6978
7446
|
# @return [::Gapic::Config::Method]
|
|
6979
7447
|
#
|
|
@@ -7263,6 +7731,21 @@ module Google
|
|
|
7263
7731
|
# @return [::Gapic::Config::Method]
|
|
7264
7732
|
#
|
|
7265
7733
|
attr_reader :execute_ontap_patch
|
|
7734
|
+
##
|
|
7735
|
+
# RPC-specific configuration for `restore_volume`
|
|
7736
|
+
# @return [::Gapic::Config::Method]
|
|
7737
|
+
#
|
|
7738
|
+
attr_reader :restore_volume
|
|
7739
|
+
##
|
|
7740
|
+
# RPC-specific configuration for `list_backup_configs`
|
|
7741
|
+
# @return [::Gapic::Config::Method]
|
|
7742
|
+
#
|
|
7743
|
+
attr_reader :list_backup_configs
|
|
7744
|
+
##
|
|
7745
|
+
# RPC-specific configuration for `update_backup_config`
|
|
7746
|
+
# @return [::Gapic::Config::Method]
|
|
7747
|
+
#
|
|
7748
|
+
attr_reader :update_backup_config
|
|
7266
7749
|
|
|
7267
7750
|
# @private
|
|
7268
7751
|
def initialize parent_rpcs = nil
|
|
@@ -7292,6 +7775,10 @@ module Google
|
|
|
7292
7775
|
@delete_volume = ::Gapic::Config::Method.new delete_volume_config
|
|
7293
7776
|
revert_volume_config = parent_rpcs.revert_volume if parent_rpcs.respond_to? :revert_volume
|
|
7294
7777
|
@revert_volume = ::Gapic::Config::Method.new revert_volume_config
|
|
7778
|
+
start_split_config = parent_rpcs.start_split if parent_rpcs.respond_to? :start_split
|
|
7779
|
+
@start_split = ::Gapic::Config::Method.new start_split_config
|
|
7780
|
+
get_split_status_config = parent_rpcs.get_split_status if parent_rpcs.respond_to? :get_split_status
|
|
7781
|
+
@get_split_status = ::Gapic::Config::Method.new get_split_status_config
|
|
7295
7782
|
establish_volume_peering_config = parent_rpcs.establish_volume_peering if parent_rpcs.respond_to? :establish_volume_peering
|
|
7296
7783
|
@establish_volume_peering = ::Gapic::Config::Method.new establish_volume_peering_config
|
|
7297
7784
|
list_snapshots_config = parent_rpcs.list_snapshots if parent_rpcs.respond_to? :list_snapshots
|
|
@@ -7408,6 +7895,12 @@ module Google
|
|
|
7408
7895
|
@execute_ontap_delete = ::Gapic::Config::Method.new execute_ontap_delete_config
|
|
7409
7896
|
execute_ontap_patch_config = parent_rpcs.execute_ontap_patch if parent_rpcs.respond_to? :execute_ontap_patch
|
|
7410
7897
|
@execute_ontap_patch = ::Gapic::Config::Method.new execute_ontap_patch_config
|
|
7898
|
+
restore_volume_config = parent_rpcs.restore_volume if parent_rpcs.respond_to? :restore_volume
|
|
7899
|
+
@restore_volume = ::Gapic::Config::Method.new restore_volume_config
|
|
7900
|
+
list_backup_configs_config = parent_rpcs.list_backup_configs if parent_rpcs.respond_to? :list_backup_configs
|
|
7901
|
+
@list_backup_configs = ::Gapic::Config::Method.new list_backup_configs_config
|
|
7902
|
+
update_backup_config_config = parent_rpcs.update_backup_config if parent_rpcs.respond_to? :update_backup_config
|
|
7903
|
+
@update_backup_config = ::Gapic::Config::Method.new update_backup_config_config
|
|
7411
7904
|
|
|
7412
7905
|
yield self if block_given?
|
|
7413
7906
|
end
|