google-cloud-netapp-v1 2.12.1 → 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.
Files changed (49) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +0 -1
  3. data/lib/google/cloud/netapp/v1/backup_pb.rb +2 -1
  4. data/lib/google/cloud/netapp/v1/backup_vault_pb.rb +1 -1
  5. data/lib/google/cloud/netapp/v1/bindings_override.rb +1 -1
  6. data/lib/google/cloud/netapp/v1/cloud_netapp_service_pb.rb +1 -1
  7. data/lib/google/cloud/netapp/v1/cloud_netapp_service_services_pb.rb +20 -5
  8. data/lib/google/cloud/netapp/v1/common_pb.rb +2 -1
  9. data/lib/google/cloud/netapp/v1/kms_pb.rb +1 -1
  10. data/lib/google/cloud/netapp/v1/netapp/client.rb +535 -7
  11. data/lib/google/cloud/netapp/v1/netapp/credentials.rb +1 -1
  12. data/lib/google/cloud/netapp/v1/netapp/operations.rb +1 -1
  13. data/lib/google/cloud/netapp/v1/netapp/paths.rb +22 -1
  14. data/lib/google/cloud/netapp/v1/netapp/rest/client.rb +500 -7
  15. data/lib/google/cloud/netapp/v1/netapp/rest/operations.rb +1 -1
  16. data/lib/google/cloud/netapp/v1/netapp/rest/service_stub.rb +309 -1
  17. data/lib/google/cloud/netapp/v1/netapp/rest.rb +1 -1
  18. data/lib/google/cloud/netapp/v1/netapp.rb +1 -1
  19. data/lib/google/cloud/netapp/v1/rest.rb +1 -1
  20. data/lib/google/cloud/netapp/v1/version.rb +1 -1
  21. data/lib/google/cloud/netapp/v1/volume_pb.rb +14 -1
  22. data/lib/google/cloud/netapp/v1.rb +1 -1
  23. data/lib/google-cloud-netapp-v1.rb +1 -1
  24. data/proto_docs/google/api/client.rb +1 -1
  25. data/proto_docs/google/api/field_behavior.rb +1 -1
  26. data/proto_docs/google/api/field_info.rb +1 -1
  27. data/proto_docs/google/api/launch_stage.rb +1 -1
  28. data/proto_docs/google/api/resource.rb +1 -1
  29. data/proto_docs/google/cloud/netapp/v1/active_directory.rb +1 -1
  30. data/proto_docs/google/cloud/netapp/v1/backup.rb +25 -5
  31. data/proto_docs/google/cloud/netapp/v1/backup_policy.rb +1 -1
  32. data/proto_docs/google/cloud/netapp/v1/backup_vault.rb +3 -3
  33. data/proto_docs/google/cloud/netapp/v1/cloud_netapp_service.rb +1 -1
  34. data/proto_docs/google/cloud/netapp/v1/common.rb +13 -1
  35. data/proto_docs/google/cloud/netapp/v1/kms.rb +2 -2
  36. data/proto_docs/google/cloud/netapp/v1/ontap.rb +1 -1
  37. data/proto_docs/google/cloud/netapp/v1/quota_rule.rb +1 -1
  38. data/proto_docs/google/cloud/netapp/v1/replication.rb +1 -1
  39. data/proto_docs/google/cloud/netapp/v1/snapshot.rb +1 -1
  40. data/proto_docs/google/cloud/netapp/v1/storage_pool.rb +3 -3
  41. data/proto_docs/google/cloud/netapp/v1/volume.rb +200 -5
  42. data/proto_docs/google/longrunning/operations.rb +1 -1
  43. data/proto_docs/google/protobuf/any.rb +1 -1
  44. data/proto_docs/google/protobuf/duration.rb +1 -1
  45. data/proto_docs/google/protobuf/empty.rb +1 -1
  46. data/proto_docs/google/protobuf/field_mask.rb +1 -1
  47. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  48. data/proto_docs/google/rpc/status.rb +1 -1
  49. metadata +1 -1
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2023 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -102,6 +102,27 @@ module Google
102
102
  "projects/#{project}/locations/#{location}/backupVaults/#{backup_vault}"
103
103
  end
104
104
 
105
+ ##
106
+ # Create a fully-qualified CryptoKey resource string.
107
+ #
108
+ # The resource will be in the following format:
109
+ #
110
+ # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`
111
+ #
112
+ # @param project [String]
113
+ # @param location [String]
114
+ # @param key_ring [String]
115
+ # @param crypto_key [String]
116
+ #
117
+ # @return [::String]
118
+ def crypto_key_path project:, location:, key_ring:, crypto_key:
119
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
120
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
121
+ raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
122
+
123
+ "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}"
124
+ end
125
+
105
126
  ##
106
127
  # Create a fully-qualified HostGroup resource string.
107
128
  #
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2023 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -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 ip addresses to be used for peering.
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` dispatches the ONTAP `POST` request to the
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 resource path of the ONTAP resource.
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` dispatches the ONTAP `GET` request to the
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` dispatches the ONTAP `DELETE` request to the
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` dispatches the ONTAP `PATCH` request to the
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
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2023 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.