aws-sdk-datasync 1.48.0 → 1.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd6bbd2b4bc78fc6d4b88d163675f6e951060df52a590a11f3078f8405834930
-  data.tar.gz: 5c416587f63dc2314e812f6620a8f5e61b96ec0f066bf2941d0b944432be91d9
+  metadata.gz: b982cb9b2c148223fc8280b38de78c603c532efab22fe1364f05edd5f06fac6e
+  data.tar.gz: 3b9bd532bb4675bd78e528a514a6e521fbc7ebaa3faa7c2f948ef5f430dafcfe
 SHA512:
-  metadata.gz: 1d161dfc927a944b5264cb5bc5c2d0bd92417356f7083dfde598cb9a49241631d69e0f6e8d04da4b40b9f69b1fd240792e505fca023a0609f93382fc866eeb39
-  data.tar.gz: 64c165aa7e495ec1b8892a6302116674d279658b358109dc5a16122b10eb5e45a7fd0dc182d0d2c1358d628d3ab2bec729baca75c5b7a5802b734443bf3e6e99
+  metadata.gz: 20246f3af604dd27eb182fc450d54b47daa43568a43fbcbe78c685d2fa43ff1735af4043028cba5d56b0483b65c353dbcb1f0223e1d6709c489ea11edc96927f
+  data.tar.gz: 5d0e1a59e970026acdc89bc6ea7bc3175a7c6475f88041f4f3f27c315a919918f719e821f681f4e349dae78cf02f004f3716da582d291e3892cf5134bf5435a5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.49.0 (2022-07-15)
+------------------
+
+* Feature - Documentation updates for AWS DataSync regarding configuring Amazon FSx for ONTAP location security groups and SMB user permissions.
+
 1.48.0 (2022-06-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.48.0
+1.49.0

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

@@ -658,17 +658,18 @@ module Aws::DataSync
     #   Amazon FSx file system.
     #
     # @option params [required, Array<String>] :security_group_arns
-    #   Specifies the security groups that DataSync can use to access your FSx
-    #   for ONTAP file system. You must configure the security groups to allow
-    #   outbound traffic on the following ports (depending on the protocol
-    #   that you're using):
+    #   Specifies the Amazon EC2 security groups that provide access to your
+    #   file system's preferred subnet.
     #
-    #   * **Network File System (NFS)**\: TCP port 2049
+    #   The security groups must allow outbound traffic on the following ports
+    #   (depending on the protocol you use):
+    #
+    #   * **Network File System (NFS)**\: TCP ports 111, 635, and 2049
     #
     #   * **Server Message Block (SMB)**\: TCP port 445
     #
     #   Your file system's security groups must also allow inbound traffic on
-    #   the same port.
+    #   the same ports.
     #
     # @option params [required, String] :storage_virtual_machine_arn
     #   Specifies the ARN of the storage virtual machine (SVM) on your file
@@ -812,40 +813,49 @@ module Aws::DataSync
     # system.
     #
     # @option params [String] :subdirectory
-    #   A subdirectory in the location's path. This subdirectory in the
-    #   Amazon FSx for Windows File Server file system is used to read data
-    #   from the Amazon FSx for Windows File Server source location or write
-    #   data to the FSx for Windows File Server destination.
+    #   Specifies a mount path for your file system using forward slashes.
+    #   This is where DataSync reads or writes data (depending on if this is a
+    #   source or destination location).
     #
     # @option params [required, String] :fsx_filesystem_arn
-    #   The Amazon Resource Name (ARN) for the FSx for Windows File Server
-    #   file system.
+    #   Specifies the Amazon Resource Name (ARN) for the FSx for Windows File
+    #   Server file system.
     #
     # @option params [required, Array<String>] :security_group_arns
-    #   The ARNs of the security groups that are used to configure the FSx for
-    #   Windows File Server file system.
+    #   Specifies the ARNs of the security groups that provide access to your
+    #   file system's preferred subnet.
+    #
+    #   <note markdown="1"> If you choose a security group that doesn't allow connections from
+    #   within itself, do one of the following:
+    #
+    #    * Configure the security group to allow it to communicate within
+    #     itself.
+    #
+    #   * Choose a different security group that can communicate with the
+    #     mount target's security group.
+    #
+    #    </note>
     #
     # @option params [Array<Types::TagListEntry>] :tags
-    #   The key-value pair that represents a tag that you want to add to the
-    #   resource. The value can be an empty string. This value helps you
-    #   manage, filter, and search for your resources. We recommend that you
-    #   create a name tag for your location.
+    #   Specifies labels that help you categorize, filter, and search for your
+    #   Amazon Web Services resources. We recommend creating at least a name
+    #   tag for your location.
     #
     # @option params [required, String] :user
-    #   The user who has the permissions to access files and folders in the
-    #   FSx for Windows File Server file system.
+    #   Specifies the user who has the permissions to access files and folders
+    #   in the file system.
     #
     #   For information about choosing a user name that ensures sufficient
     #   permissions to files, folders, and metadata, see
     #   [user](create-fsx-location.html#FSxWuser).
     #
     # @option params [String] :domain
-    #   The name of the Windows domain that the FSx for Windows File Server
-    #   belongs to.
+    #   Specifies the name of the Windows domain that the FSx for Windows File
+    #   Server belongs to.
     #
     # @option params [required, String] :password
-    #   The password of the user who has the permissions to access files and
-    #   folders in the FSx for Windows File Server file system.
+    #   Specifies the password of the user who has the permissions to access
+    #   files and folders in the file system.
     #
     # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1399,33 +1409,27 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates a task.
+    # Configures a task, which defines where and how DataSync transfers your
+    # data.
     #
-    # A task includes a source location and a destination location, and a
-    # configuration that specifies how data is transferred. A task always
-    # transfers data from the source location to the destination location.
-    # The configuration specifies options such as task scheduling, bandwidth
-    # limits, etc. A task is the complete definition of a data transfer.
+    # A task includes a source location, a destination location, and the
+    # preferences for how and when you want to transfer your data (such as
+    # bandwidth limits, scheduling, among other options).
     #
     # When you create a task that transfers data between Amazon Web Services
-    # services in different Amazon Web Services Regions, one of the two
-    # locations that you specify must reside in the Region where DataSync is
-    # being used. The other location must be specified in a different
-    # Region.
+    # services in different Amazon Web Services Regions, one of your
+    # locations must reside in the Region where you're using DataSync.
+    #
+    # For more information, see the following topics:
     #
-    # You can transfer data between commercial Amazon Web Services Regions
-    # except for China, or between Amazon Web Services GovCloud (US)
-    # Regions.
+    # * [Working with DataSync locations][1]
     #
-    # When you use DataSync to copy files or objects between Amazon Web
-    # Services Regions, you pay for data transfer between Regions. This is
-    # billed as data transfer OUT from your source Region to your
-    # destination Region. For more information, see [Data Transfer
-    # pricing][1].
+    # * [Configure DataSync task settings][2]
     #
     #
     #
-    # [1]: http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html
+    # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html
     #
     # @option params [required, String] :source_location_arn
     #   The Amazon Resource Name (ARN) of the source location for the task.
@@ -2446,7 +2450,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns a list of all the tasks.
+    # Returns a list of the DataSync tasks you created.
     #
     # @option params [Integer] :max_results
     #   The maximum number of tasks to return.
@@ -3177,7 +3181,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.48.0'
+      context[:gem_version] = '1.49.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -378,17 +378,18 @@ module Aws::DataSync
     #   @return [Types::FsxProtocol]
     #
     # @!attribute [rw] security_group_arns
-    #   Specifies the security groups that DataSync can use to access your
-    #   FSx for ONTAP file system. You must configure the security groups to
-    #   allow outbound traffic on the following ports (depending on the
-    #   protocol that you're using):
+    #   Specifies the Amazon EC2 security groups that provide access to your
+    #   file system's preferred subnet.
     #
-    #   * **Network File System (NFS)**\: TCP port 2049
+    #   The security groups must allow outbound traffic on the following
+    #   ports (depending on the protocol you use):
+    #
+    #   * **Network File System (NFS)**\: TCP ports 111, 635, and 2049
     #
     #   * **Server Message Block (SMB)**\: TCP port 445
     #
     #   Your file system's security groups must also allow inbound traffic
-    #   on the same port.
+    #   on the same ports.
     #   @return [Array<String>]
     #
     # @!attribute [rw] storage_virtual_machine_arn
@@ -542,32 +543,41 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] subdirectory
-    #   A subdirectory in the location's path. This subdirectory in the
-    #   Amazon FSx for Windows File Server file system is used to read data
-    #   from the Amazon FSx for Windows File Server source location or write
-    #   data to the FSx for Windows File Server destination.
+    #   Specifies a mount path for your file system using forward slashes.
+    #   This is where DataSync reads or writes data (depending on if this is
+    #   a source or destination location).
     #   @return [String]
     #
     # @!attribute [rw] fsx_filesystem_arn
-    #   The Amazon Resource Name (ARN) for the FSx for Windows File Server
-    #   file system.
+    #   Specifies the Amazon Resource Name (ARN) for the FSx for Windows
+    #   File Server file system.
     #   @return [String]
     #
     # @!attribute [rw] security_group_arns
-    #   The ARNs of the security groups that are used to configure the FSx
-    #   for Windows File Server file system.
+    #   Specifies the ARNs of the security groups that provide access to
+    #   your file system's preferred subnet.
+    #
+    #   <note markdown="1"> If you choose a security group that doesn't allow connections from
+    #   within itself, do one of the following:
+    #
+    #    * Configure the security group to allow it to communicate within
+    #     itself.
+    #
+    #   * Choose a different security group that can communicate with the
+    #     mount target's security group.
+    #
+    #    </note>
     #   @return [Array<String>]
     #
     # @!attribute [rw] tags
-    #   The key-value pair that represents a tag that you want to add to the
-    #   resource. The value can be an empty string. This value helps you
-    #   manage, filter, and search for your resources. We recommend that you
-    #   create a name tag for your location.
+    #   Specifies labels that help you categorize, filter, and search for
+    #   your Amazon Web Services resources. We recommend creating at least a
+    #   name tag for your location.
     #   @return [Array<Types::TagListEntry>]
     #
     # @!attribute [rw] user
-    #   The user who has the permissions to access files and folders in the
-    #   FSx for Windows File Server file system.
+    #   Specifies the user who has the permissions to access files and
+    #   folders in the file system.
     #
     #   For information about choosing a user name that ensures sufficient
     #   permissions to files, folders, and metadata, see
@@ -575,13 +585,13 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] domain
-    #   The name of the Windows domain that the FSx for Windows File Server
-    #   belongs to.
+    #   Specifies the name of the Windows domain that the FSx for Windows
+    #   File Server belongs to.
     #   @return [String]
     #
     # @!attribute [rw] password
-    #   The password of the user who has the permissions to access files and
-    #   folders in the FSx for Windows File Server file system.
+    #   Specifies the password of the user who has the permissions to access
+    #   files and folders in the file system.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxWindowsRequest AWS API Documentation
@@ -599,8 +609,8 @@ module Aws::DataSync
     end
 
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the FSx for Windows File Server
-    #   file system location you created.
+    #   The ARN of the FSx for Windows File Server file system location you
+    #   created.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxWindowsResponse AWS API Documentation
@@ -2660,7 +2670,37 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] user
-    #   Specifies a user who has permission to access your SVM.
+    #   Specifies a user name that can mount the location and access the
+    #   files, folders, and metadata that you need in the SVM.
+    #
+    #   If you provide a user in your Active Directory, note the following:
+    #
+    #   * If you're using Directory Service for Microsoft Active Directory,
+    #     the user must be a member of the Amazon Web Services Delegated FSx
+    #     Administrators group.
+    #
+    #   * If you're using a self-managed Active Directory, the user must be
+    #     a member of either the Domain Admins group or a custom group that
+    #     you specified for file system administration when you created your
+    #     file system.
+    #
+    #   Make sure that the user has the permissions it needs to copy the
+    #   data you want:
+    #
+    #   * `SE_TCB_NAME`\: Required to set object ownership and file
+    #     metadata. With this privilege, you also can copy NTFS
+    #     discretionary access lists (DACLs).
+    #
+    #   * `SE_SECURITY_NAME`\: May be needed to copy NTFS system access
+    #     control lists (SACLs). This operation specifically requires the
+    #     Windows privilege, which is granted to members of the Domain
+    #     Admins group. If you configure your task to copy SACLs, make sure
+    #     that the user has the required privileges. For information about
+    #     copying SACLs, see [Ownership and permissions-related options][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html#configure-ownership-and-permissions
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/FsxProtocolSmb AWS API Documentation
@@ -3029,10 +3069,16 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # You can use API filters to narrow down the list of resources returned
-    # by `ListLocations`. For example, to retrieve all your Amazon S3
-    # locations, you can use `ListLocations` with filter name `LocationType
-    # S3` and `Operator Equals`.
+    # Narrow down the list of resources returned by `ListLocations`. For
+    # example, to see all your Amazon S3 locations, create a filter using
+    # `"Name": "LocationType"`, `"Operator": "Equals"`, and `"Values":
+    # "S3"`.
+    #
+    # For more information, see [filtering resources][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
     #
     # @note When making an API call, you may pass LocationFilter
     #   data as a hash:
@@ -3056,12 +3102,7 @@ module Aws::DataSync
     #
     # @!attribute [rw] operator
     #   The operator that is used to compare filter values (for example,
-    #   `Equals` or `Contains`). For more about API filtering operators, see
-    #   [API filters for ListTasks and ListLocations][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
+    #   `Equals` or `Contains`).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/LocationFilter AWS API Documentation
@@ -3929,6 +3970,12 @@ module Aws::DataSync
     # location, you can use `ListTasks` with filter name `LocationId` and
     # `Operator Equals` with the ARN for the location.
     #
+    # For more information, see [filtering DataSync resources][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
+    #
     # @note When making an API call, you may pass TaskFilter
     #   data as a hash:
     #
@@ -3951,12 +3998,7 @@ module Aws::DataSync
     #
     # @!attribute [rw] operator
     #   The operator that is used to compare filter values (for example,
-    #   `Equals` or `Contains`). For more about API filtering operators, see
-    #   [API filters for ListTasks and ListLocations][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html
+    #   `Equals` or `Contains`).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskFilter AWS API Documentation

data/lib/aws-sdk-datasync.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.48.0'
+  GEM_VERSION = '1.49.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.48.0
+  version: 1.49.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-28 00:00:00.000000000 Z
+date: 2022-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core