aws-sdk-datasync 1.63.0 → 1.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47476be9fe777713cef4cad10751a5312eeb8f190d6a891725b2cdd3de389e73
-  data.tar.gz: b6e169c01a64492b9de1195331b622d4fcf81f7a6a4d83ae4a1d01ecbcb9e355
+  metadata.gz: 57f28f79db439d714373ac5f32860203ba051d0049a3b3a999ae8dea31aa1675
+  data.tar.gz: 7719ec1da51d741b92c4de227f2040219aac876f1538625397ff91027a972af4
 SHA512:
-  metadata.gz: b18e962f3747cbf94befe830cf6d088556880455e3bc81e790275e33c103b52d1ea07385382aa7062d34fd504be5b9fc766f5c4e0fc7ffe8285f105e5e547140
-  data.tar.gz: e75ffea5c597baef2c3330e290caf49c794b7dec1815d700bdb5f97aae875542275ae728fb152a317b42470bba3c59585a4fa7d617713bd8e5b61d2846fe2c9e
+  metadata.gz: ff312076f54c88de8792694c943bfca0dba6163fca652a46eb675a36173bfc7d96a934ac89f7cd0adab30ebd612fd68cbf56fde5157fe05695b5879ec8b6f13e
+  data.tar.gz: 992649735bbc619082bb1f6a9e023a7250a13e3b19cb60dd239c9d579213f1958f99305616ec0dbe0b7aa032a478fc0a5c6ddf970d82f8b894747084ca44f83c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.64.0 (2023-08-04)
+------------------
+
+* Feature - Display cloud storage used capacity at a cluster level.
+
 1.63.0 (2023-07-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.63.0
+1.64.0

data/lib/aws-sdk-datasync/client.rb

@@ -1256,67 +1256,53 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates an endpoint for an Network File System (NFS) file server that
+    # Creates an endpoint for a Network File System (NFS) file server that
     # DataSync can use for a data transfer.
     #
-    # @option params [required, String] :subdirectory
-    #   Specifies the subdirectory in the NFS file server that DataSync
-    #   transfers to or from. The NFS path should be a path that's exported
-    #   by the NFS server, or a subdirectory of that path. The path should be
-    #   such that it can be mounted by other NFS clients in your network.
-    #
-    #   To see all the paths exported by your NFS server, run "`showmount -e
-    #   nfs-server-name`" from an NFS client that has access to your server.
-    #   You can specify any directory that appears in the results, and any
-    #   subdirectory of that directory. Ensure that the NFS export is
-    #   accessible without Kerberos authentication.
-    #
-    #   To transfer all the data in the folder you specified, DataSync needs
-    #   to have permissions to read all the data. To ensure this, either
-    #   configure the NFS export with `no_root_squash,` or ensure that the
-    #   permissions for all of the files that you want DataSync allow read
-    #   access for all users. Doing either enables the agent to read the
-    #   files. For the agent to access directories, you must additionally
-    #   enable all execute access.
+    # For more information, see [Configuring transfers to or from an NFS
+    # file server][1].
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    # <note markdown="1"> If you're copying data to or from an Snowcone device, you can also
+    # use `CreateLocationNfs` to create your transfer location. For more
+    # information, see [Configuring transfers with Snowcone][2].
     #
+    #  </note>
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
     #
-    # @option params [required, String] :server_hostname
-    #   Specifies the IP address or domain name of your NFS file server. An
-    #   agent that is installed on-premises uses this hostname to mount the
-    #   NFS server in a network.
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
+    # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/nfs-on-snowcone.html
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    # @option params [required, String] :subdirectory
+    #   Specifies the export path in your NFS file server that you want
+    #   DataSync to mount.
     #
-    #   <note markdown="1"> You must specify be an IP version 4 address or Domain Name System
-    #   (DNS)-compliant name.
+    #   This path (or a subdirectory of the path) is where DataSync transfers
+    #   data to or from. For information on configuring an export for
+    #   DataSync, see [Accessing NFS file servers][1].
     #
-    #    </note>
     #
     #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    # @option params [required, String] :server_hostname
+    #   Specifies the Domain Name System (DNS) name or IP version 4 address of
+    #   the NFS file server that your DataSync agent connects to.
     #
     # @option params [required, Types::OnPremConfig] :on_prem_config
-    #   Specifies the Amazon Resource Names (ARNs) of agents that DataSync
-    #   uses to connect to your NFS file server.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent that
+    #   want to connect to your NFS file server.
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    #   You can specify more than one agent. For more information, see [Using
+    #   multiple agents for transfers][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
     #
     # @option params [Types::NfsMountOptions] :mount_options
-    #   Specifies the mount options that DataSync can use to mount your NFS
-    #   share.
+    #   Specifies the options that DataSync can use to mount your NFS file
+    #   server.
     #
     # @option params [Array<Types::TagListEntry>] :tags
     #   Specifies labels that help you categorize, filter, and search for your
@@ -2300,10 +2286,12 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns metadata, such as the path information, about an NFS location.
+    # Provides details about how an DataSync transfer location for a Network
+    # File System (NFS) file server is configured.
     #
     # @option params [required, String] :location_arn
-    #   The Amazon Resource Name (ARN) of the NFS location to describe.
+    #   Specifies the Amazon Resource Name (ARN) of the NFS location that you
+    #   want information about.
     #
     # @return [Types::DescribeLocationNfsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2585,6 +2573,7 @@ module Aws::DataSync
     #   resp.metrics[0].capacity.used #=> Integer
     #   resp.metrics[0].capacity.provisioned #=> Integer
     #   resp.metrics[0].capacity.logical_used #=> Integer
+    #   resp.metrics[0].capacity.cluster_cloud_storage_used #=> Integer
     #   resp.metrics[0].resource_id #=> String
     #   resp.metrics[0].resource_type #=> String, one of "SVM", "VOLUME", "CLUSTER"
     #   resp.next_token #=> String
@@ -2735,6 +2724,7 @@ module Aws::DataSync
     #   resp.resource_details.net_app_ontap_clusters[0].recommendations[0].estimated_monthly_storage_cost #=> String
     #   resp.resource_details.net_app_ontap_clusters[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
     #   resp.resource_details.net_app_ontap_clusters[0].lun_count #=> Integer
+    #   resp.resource_details.net_app_ontap_clusters[0].cluster_cloud_storage_used #=> Integer
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResources AWS API Documentation
@@ -3820,49 +3810,35 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates some of the parameters of a previously created location for
-    # Network File System (NFS) access. For information about creating an
-    # NFS location, see [Creating a location for NFS][1].
+    # Modifies some configurations of the Network File System (NFS) transfer
+    # location that you're using with DataSync.
+    #
+    # For more information, see [Configuring transfers to or from an NFS
+    # file server][1].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
     #
     # @option params [required, String] :location_arn
-    #   Specifies the Amazon Resource Name (ARN) of the NFS location that you
-    #   want to update.
+    #   Specifies the Amazon Resource Name (ARN) of the NFS transfer location
+    #   that you want to update.
     #
     # @option params [String] :subdirectory
-    #   Specifies the subdirectory in your NFS file system that DataSync uses
-    #   to read from or write to during a transfer. The NFS path should be
-    #   exported by the NFS server, or a subdirectory of that path. The path
-    #   should be such that it can be mounted by other NFS clients in your
-    #   network.
-    #
-    #   To see all the paths exported by your NFS server, run "`showmount -e
-    #   nfs-server-name`" from an NFS client that has access to your server.
-    #   You can specify any directory that appears in the results, and any
-    #   subdirectory of that directory. Ensure that the NFS export is
-    #   accessible without Kerberos authentication.
-    #
-    #   To transfer all the data in the folder that you specified, DataSync
-    #   must have permissions to read all the data. To ensure this, either
-    #   configure the NFS export with `no_root_squash`, or ensure that the
-    #   files you want DataSync to access have permissions that allow read
-    #   access for all users. Doing either option enables the agent to read
-    #   the files. For the agent to access directories, you must additionally
-    #   enable all execute access.
+    #   Specifies the export path in your NFS file server that you want
+    #   DataSync to mount.
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    #   This path (or a subdirectory of the path) is where DataSync transfers
+    #   data to or from. For information on configuring an export for
+    #   DataSync, see [Accessing NFS file servers][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
     #
     # @option params [Types::OnPremConfig] :on_prem_config
-    #   A list of Amazon Resource Names (ARNs) of agents to use for a Network
-    #   File System (NFS) location.
+    #   The DataSync agents that are connecting to a Network File System (NFS)
+    #   location.
     #
     # @option params [Types::NfsMountOptions] :mount_options
     #   Specifies how DataSync can access a location using the NFS protocol.
@@ -4274,7 +4250,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.63.0'
+      context[:gem_version] = '1.64.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-datasync/client_api.rb

@@ -360,6 +360,7 @@ module Aws::DataSync
     Capacity.add_member(:used, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "Used"))
     Capacity.add_member(:provisioned, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "Provisioned"))
     Capacity.add_member(:logical_used, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "LogicalUsed"))
+    Capacity.add_member(:cluster_cloud_storage_used, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "ClusterCloudStorageUsed"))
     Capacity.struct_class = Types::Capacity
 
     CreateAgentRequest.add_member(:activation_key, Shapes::ShapeRef.new(shape: ActivationKey, required: true, location_name: "ActivationKey"))
@@ -950,6 +951,7 @@ module Aws::DataSync
     NetAppONTAPCluster.add_member(:recommendations, Shapes::ShapeRef.new(shape: Recommendations, location_name: "Recommendations"))
     NetAppONTAPCluster.add_member(:recommendation_status, Shapes::ShapeRef.new(shape: RecommendationStatus, location_name: "RecommendationStatus"))
     NetAppONTAPCluster.add_member(:lun_count, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "LunCount"))
+    NetAppONTAPCluster.add_member(:cluster_cloud_storage_used, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "ClusterCloudStorageUsed"))
     NetAppONTAPCluster.struct_class = Types::NetAppONTAPCluster
 
     NetAppONTAPClusters.member = Shapes::ShapeRef.new(shape: NetAppONTAPCluster)

data/lib/aws-sdk-datasync/types.rb

@@ -184,12 +184,18 @@ module Aws::DataSync
     #   without accounting for compression or deduplication.
     #   @return [Integer]
     #
+    # @!attribute [rw] cluster_cloud_storage_used
+    #   The amount of space in the cluster that's in cloud storage (for
+    #   example, if you're using data tiering).
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Capacity AWS API Documentation
     #
     class Capacity < Struct.new(
       :used,
       :provisioned,
-      :logical_used)
+      :logical_used,
+      :cluster_cloud_storage_used)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -837,66 +843,38 @@ module Aws::DataSync
     # CreateLocationNfsRequest
     #
     # @!attribute [rw] subdirectory
-    #   Specifies the subdirectory in the NFS file server that DataSync
-    #   transfers to or from. The NFS path should be a path that's exported
-    #   by the NFS server, or a subdirectory of that path. The path should
-    #   be such that it can be mounted by other NFS clients in your network.
-    #
-    #   To see all the paths exported by your NFS server, run "`showmount
-    #   -e nfs-server-name`" from an NFS client that has access to your
-    #   server. You can specify any directory that appears in the results,
-    #   and any subdirectory of that directory. Ensure that the NFS export
-    #   is accessible without Kerberos authentication.
-    #
-    #   To transfer all the data in the folder you specified, DataSync needs
-    #   to have permissions to read all the data. To ensure this, either
-    #   configure the NFS export with `no_root_squash,` or ensure that the
-    #   permissions for all of the files that you want DataSync allow read
-    #   access for all users. Doing either enables the agent to read the
-    #   files. For the agent to access directories, you must additionally
-    #   enable all execute access.
+    #   Specifies the export path in your NFS file server that you want
+    #   DataSync to mount.
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    #   This path (or a subdirectory of the path) is where DataSync
+    #   transfers data to or from. For information on configuring an export
+    #   for DataSync, see [Accessing NFS file servers][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
     #   @return [String]
     #
     # @!attribute [rw] server_hostname
-    #   Specifies the IP address or domain name of your NFS file server. An
-    #   agent that is installed on-premises uses this hostname to mount the
-    #   NFS server in a network.
-    #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
-    #
-    #   <note markdown="1"> You must specify be an IP version 4 address or Domain Name System
-    #   (DNS)-compliant name.
-    #
-    #    </note>
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   Specifies the Domain Name System (DNS) name or IP version 4 address
+    #   of the NFS file server that your DataSync agent connects to.
     #   @return [String]
     #
     # @!attribute [rw] on_prem_config
-    #   Specifies the Amazon Resource Names (ARNs) of agents that DataSync
-    #   uses to connect to your NFS file server.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent that
+    #   want to connect to your NFS file server.
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    #   You can specify more than one agent. For more information, see
+    #   [Using multiple agents for transfers][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
     #   @return [Types::OnPremConfig]
     #
     # @!attribute [rw] mount_options
-    #   Specifies the mount options that DataSync can use to mount your NFS
-    #   share.
+    #   Specifies the options that DataSync can use to mount your NFS file
+    #   server.
     #   @return [Types::NfsMountOptions]
     #
     # @!attribute [rw] tags
@@ -1978,7 +1956,8 @@ module Aws::DataSync
     # DescribeLocationNfsRequest
     #
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the NFS location to describe.
+    #   Specifies the Amazon Resource Name (ARN) of the NFS location that
+    #   you want information about.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationNfsRequest AWS API Documentation
@@ -1992,25 +1971,24 @@ module Aws::DataSync
     # DescribeLocationNfsResponse
     #
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the NFS location that was
-    #   described.
+    #   The ARN of the NFS location.
     #   @return [String]
     #
     # @!attribute [rw] location_uri
-    #   The URL of the source NFS location that was described.
+    #   The URL of the NFS location.
     #   @return [String]
     #
     # @!attribute [rw] on_prem_config
-    #   A list of Amazon Resource Names (ARNs) of agents to use for a
-    #   Network File System (NFS) location.
+    #   The DataSync agents that are connecting to a Network File System
+    #   (NFS) location.
     #   @return [Types::OnPremConfig]
     #
     # @!attribute [rw] mount_options
-    #   The mount options that DataSync uses to mount your NFS share.
+    #   The mount options that DataSync uses to mount your NFS file server.
     #   @return [Types::NfsMountOptions]
     #
     # @!attribute [rw] creation_time
-    #   The time that the NFS location was created.
+    #   The time when the NFS location was created.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationNfsResponse AWS API Documentation
@@ -3645,6 +3623,11 @@ module Aws::DataSync
     #   The number of LUNs (logical unit numbers) in the cluster.
     #   @return [Integer]
     #
+    # @!attribute [rw] cluster_cloud_storage_used
+    #   The amount of space in the cluster that's in cloud storage (for
+    #   example, if you're using data tiering).
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/NetAppONTAPCluster AWS API Documentation
     #
     class NetAppONTAPCluster < Struct.new(
@@ -3658,7 +3641,8 @@ module Aws::DataSync
       :cluster_block_storage_logical_used,
       :recommendations,
       :recommendation_status,
-      :lun_count)
+      :lun_count,
+      :cluster_cloud_storage_used)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3895,11 +3879,12 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # A list of Amazon Resource Names (ARNs) of agents to use for a Network
-    # File System (NFS) location.
+    # The DataSync agents that are connecting to a Network File System (NFS)
+    # location.
     #
     # @!attribute [rw] agent_arns
-    #   ARNs of the agents to use for an NFS location.
+    #   The Amazon Resource Names (ARNs) of the agents connecting to a
+    #   transfer location.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/OnPremConfig AWS API Documentation
@@ -5177,42 +5162,26 @@ module Aws::DataSync
     class UpdateLocationHdfsResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] location_arn
-    #   Specifies the Amazon Resource Name (ARN) of the NFS location that
-    #   you want to update.
+    #   Specifies the Amazon Resource Name (ARN) of the NFS transfer
+    #   location that you want to update.
     #   @return [String]
     #
     # @!attribute [rw] subdirectory
-    #   Specifies the subdirectory in your NFS file system that DataSync
-    #   uses to read from or write to during a transfer. The NFS path should
-    #   be exported by the NFS server, or a subdirectory of that path. The
-    #   path should be such that it can be mounted by other NFS clients in
-    #   your network.
-    #
-    #   To see all the paths exported by your NFS server, run "`showmount
-    #   -e nfs-server-name`" from an NFS client that has access to your
-    #   server. You can specify any directory that appears in the results,
-    #   and any subdirectory of that directory. Ensure that the NFS export
-    #   is accessible without Kerberos authentication.
-    #
-    #   To transfer all the data in the folder that you specified, DataSync
-    #   must have permissions to read all the data. To ensure this, either
-    #   configure the NFS export with `no_root_squash`, or ensure that the
-    #   files you want DataSync to access have permissions that allow read
-    #   access for all users. Doing either option enables the agent to read
-    #   the files. For the agent to access directories, you must
-    #   additionally enable all execute access.
+    #   Specifies the export path in your NFS file server that you want
+    #   DataSync to mount.
     #
-    #   If you are copying data to or from your Snowcone device, see [NFS
-    #   Server on Snowcone][1] for more information.
+    #   This path (or a subdirectory of the path) is where DataSync
+    #   transfers data to or from. For information on configuring an export
+    #   for DataSync, see [Accessing NFS file servers][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
     #   @return [String]
     #
     # @!attribute [rw] on_prem_config
-    #   A list of Amazon Resource Names (ARNs) of agents to use for a
-    #   Network File System (NFS) location.
+    #   The DataSync agents that are connecting to a Network File System
+    #   (NFS) location.
     #   @return [Types::OnPremConfig]
     #
     # @!attribute [rw] mount_options

data/lib/aws-sdk-datasync.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.63.0'
+  GEM_VERSION = '1.64.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.63.0
+  version: 1.64.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-25 00:00:00.000000000 Z
+date: 2023-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core