aws-sdk-datasync 1.48.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd6bbd2b4bc78fc6d4b88d163675f6e951060df52a590a11f3078f8405834930
-  data.tar.gz: 5c416587f63dc2314e812f6620a8f5e61b96ec0f066bf2941d0b944432be91d9
+  metadata.gz: de98f67944d2f42d6f628d7a2382dfa14de614e403a227d99166201fa7c8846d
+  data.tar.gz: 1ba4385bf18d52321ee75346b0a307e1f86da888576cfe05a00a2caa0afe03c9
 SHA512:
-  metadata.gz: 1d161dfc927a944b5264cb5bc5c2d0bd92417356f7083dfde598cb9a49241631d69e0f6e8d04da4b40b9f69b1fd240792e505fca023a0609f93382fc866eeb39
-  data.tar.gz: 64c165aa7e495ec1b8892a6302116674d279658b358109dc5a16122b10eb5e45a7fd0dc182d0d2c1358d628d3ab2bec729baca75c5b7a5802b734443bf3e6e99
+  metadata.gz: bc657c9af1255c068800b3deeb49c9fdba7bfc1eef0eec9cb45a52729a68849ce580c7d4393431aae3965dd86fbeaa6892518ceffa1306060a72f8ccf3eeede9
+  data.tar.gz: 4fb0b061314a00049bf9c02516f266635cfd13d7eacdca44db9d61d7e948a6a12348d43f63ad5ca2af7e8448d26c81ba91e59800b65a7f1a30c8febbb4347c12

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.50.0 (2022-10-24)
+------------------
+
+* Feature - Added support for self-signed certificates when using object storage locations; added BytesCompressed to the TaskExecution response.
+
+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.50.0

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

@@ -361,20 +361,20 @@ module Aws::DataSync
 
     # @!group API Operations
 
-    # Cancels execution of a task.
-    #
-    # When you cancel a task execution, the transfer of some files is
-    # abruptly interrupted. The contents of files that are transferred to
-    # the destination might be incomplete or inconsistent with the source
-    # files. However, if you start a new task execution on the same task and
-    # you allow the task execution to complete, file content on the
-    # destination is complete and consistent. This applies to other
-    # unexpected failures that interrupt a task execution. In all of these
-    # cases, DataSync successfully complete the transfer when you start the
-    # next task execution.
+    # Stops an DataSync task execution that's in progress. The transfer of
+    # some files are abruptly interrupted. File contents that're
+    # transferred to the destination might be incomplete or inconsistent
+    # with the source files.
+    #
+    # However, if you start a new task execution using the same task and
+    # allow it to finish, file content on the destination will be complete
+    # and consistent. This applies to other unexpected failures that
+    # interrupt a task execution. In all of these cases, DataSync
+    # successfully completes the transfer when you start the next task
+    # execution.
     #
     # @option params [required, String] :task_execution_arn
-    #   The Amazon Resource Name (ARN) of the task execution to cancel.
+    #   The Amazon Resource Name (ARN) of the task execution to stop.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -393,13 +393,13 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Activates an DataSync agent that you have deployed on your host. The
-    # activation process associates your agent with your account. In the
-    # activation process, you specify information such as the Amazon Web
-    # Services Region that you want to activate the agent in. You activate
-    # the agent in the Amazon Web Services Region where your target
-    # locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created
-    # in this Amazon Web Services Region.
+    # Activates an DataSync agent that you have deployed in your storage
+    # environment. The activation process associates your agent with your
+    # account. In the activation process, you specify information such as
+    # the Amazon Web Services Region that you want to activate the agent in.
+    # You activate the agent in the Amazon Web Services Region where your
+    # target locations (in Amazon S3 or Amazon EFS) reside. Your tasks are
+    # created in this Amazon Web Services Region.
     #
     # You can activate the agent in a VPC (virtual private cloud) or provide
     # the agent access to a VPC endpoint so you can run tasks without going
@@ -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
@@ -739,7 +740,18 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates an endpoint for an Amazon FSx for OpenZFS file system.
+    # Creates an endpoint for an Amazon FSx for OpenZFS file system that
+    # DataSync can access for a transfer. For more information, see
+    # [Creating a location for FSx for OpenZFS][1].
+    #
+    # <note markdown="1"> Request parameters related to `SMB` aren't supported with the
+    # `CreateLocationFsxOpenZfs` operation.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html
     #
     # @option params [required, String] :fsx_filesystem_arn
     #   The Amazon Resource Name (ARN) of the FSx for OpenZFS file system.
@@ -812,40 +824,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:
     #
@@ -1171,6 +1192,15 @@ module Aws::DataSync
     #   add to the resource. Tags can help you manage, filter, and search for
     #   your resources. We recommend creating a name tag for your location.
     #
+    # @option params [String, StringIO, File] :server_certificate
+    #   Specifies a certificate to authenticate with an object storage system
+    #   that uses a private or self-signed certificate authority (CA). You
+    #   must specify a Base64-encoded `.pem` file (for example,
+    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The certificate
+    #   can be up to 32768 bytes (before Base64 encoding).
+    #
+    #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
+    #
     # @return [Types::CreateLocationObjectStorageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateLocationObjectStorageResponse#location_arn #location_arn} => String
@@ -1192,6 +1222,7 @@ module Aws::DataSync
     #         value: "TagValue",
     #       },
     #     ],
+    #     server_certificate: "data",
     #   })
     #
     # @example Response structure
@@ -1207,7 +1238,8 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates an endpoint for an Amazon S3 bucket.
+    # Creates an endpoint for an Amazon S3 bucket that DataSync can access
+    # for a transfer.
     #
     # For more information, see [Create an Amazon S3 location][1] in the
     # *DataSync User Guide*.
@@ -1399,33 +1431,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.
@@ -1710,8 +1736,8 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns metadata about an Amazon FSx for Lustre location, such as
-    # information about its path.
+    # Provides details about how an DataSync location for an Amazon FSx for
+    # Lustre file system is configured.
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the FSx for Lustre location to
@@ -1750,6 +1776,11 @@ module Aws::DataSync
     # Provides details about how an DataSync location for an Amazon FSx for
     # NetApp ONTAP file system is configured.
     #
+    # <note markdown="1"> If your location uses SMB, the `DescribeLocationFsxOntap` operation
+    # doesn't actually return a `Password`.
+    #
+    #  </note>
+    #
     # @option params [required, String] :location_arn
     #   Specifies the Amazon Resource Name (ARN) of the FSx for ONTAP file
     #   system location that you want information about.
@@ -1794,8 +1825,13 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns metadata about an Amazon FSx for OpenZFS location, such as
-    # information about its path.
+    # Provides details about how an DataSync location for an Amazon FSx for
+    # OpenZFS file system is configured.
+    #
+    # <note markdown="1"> Response elements related to `SMB` aren't supported with the
+    # `DescribeLocationFsxOpenZfs` operation.
+    #
+    #  </note>
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the FSx for OpenZFS location to
@@ -1987,6 +2023,7 @@ module Aws::DataSync
     #   * {Types::DescribeLocationObjectStorageResponse#server_protocol #server_protocol} => String
     #   * {Types::DescribeLocationObjectStorageResponse#agent_arns #agent_arns} => Array&lt;String&gt;
     #   * {Types::DescribeLocationObjectStorageResponse#creation_time #creation_time} => Time
+    #   * {Types::DescribeLocationObjectStorageResponse#server_certificate #server_certificate} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -2004,6 +2041,7 @@ module Aws::DataSync
     #   resp.agent_arns #=> Array
     #   resp.agent_arns[0] #=> String
     #   resp.creation_time #=> Time
+    #   resp.server_certificate #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorage AWS API Documentation
     #
@@ -2194,6 +2232,7 @@ module Aws::DataSync
     #   * {Types::DescribeTaskExecutionResponse#bytes_written #bytes_written} => Integer
     #   * {Types::DescribeTaskExecutionResponse#bytes_transferred #bytes_transferred} => Integer
     #   * {Types::DescribeTaskExecutionResponse#result #result} => Types::TaskExecutionResultDetail
+    #   * {Types::DescribeTaskExecutionResponse#bytes_compressed #bytes_compressed} => Integer
     #
     # @example Request syntax with placeholder values
     #
@@ -2241,6 +2280,7 @@ module Aws::DataSync
     #   resp.result.verify_status #=> String, one of "PENDING", "SUCCESS", "ERROR"
     #   resp.result.error_code #=> String
     #   resp.result.error_detail #=> String
+    #   resp.bytes_compressed #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
     #
@@ -2446,7 +2486,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.
@@ -2844,48 +2884,56 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates some of the parameters of a previously created location for
-    # self-managed object storage server access. For information about
-    # creating a self-managed object storage location, see [Creating a
-    # location for object storage][1].
+    # Updates some parameters of an existing object storage location that
+    # DataSync accesses for a transfer. For information about creating a
+    # self-managed object storage location, see [Creating a location for
+    # object storage][1].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
     #
     # @option params [required, String] :location_arn
-    #   The Amazon Resource Name (ARN) of the self-managed object storage
-    #   server location to be updated.
+    #   Specifies the ARN of the object storage system location that you're
+    #   updating.
     #
     # @option params [Integer] :server_port
-    #   The port that your self-managed object storage server accepts inbound
-    #   network traffic on. The server port is set by default to TCP 80 (HTTP)
-    #   or TCP 443 (HTTPS). You can specify a custom port if your self-managed
-    #   object storage server requires one.
+    #   Specifies the port that your object storage server accepts inbound
+    #   network traffic on (for example, port 443).
     #
     # @option params [String] :server_protocol
-    #   The protocol that the object storage server uses to communicate. Valid
-    #   values are `HTTP` or `HTTPS`.
+    #   Specifies the protocol that your object storage server uses to
+    #   communicate.
     #
     # @option params [String] :subdirectory
-    #   The subdirectory in the self-managed object storage server that is
-    #   used to read data from.
+    #   Specifies the object prefix for your object storage server. If this is
+    #   a source location, DataSync only copies objects with this prefix. If
+    #   this is a destination location, DataSync writes all objects with this
+    #   prefix.
     #
     # @option params [String] :access_key
-    #   Optional. The access key is used if credentials are required to access
-    #   the self-managed object storage server. If your object storage
-    #   requires a user name and password to authenticate, use `AccessKey` and
-    #   `SecretKey` to provide the user name and password, respectively.
+    #   Specifies the access key (for example, a user name) if credentials are
+    #   required to authenticate with the object storage server.
     #
     # @option params [String] :secret_key
-    #   Optional. The secret key is used if credentials are required to access
-    #   the self-managed object storage server. If your object storage
-    #   requires a user name and password to authenticate, use `AccessKey` and
-    #   `SecretKey` to provide the user name and password, respectively.
+    #   Specifies the secret key (for example, a password) if credentials are
+    #   required to authenticate with the object storage server.
     #
     # @option params [Array<String>] :agent_arns
-    #   The Amazon Resource Name (ARN) of the agents associated with the
-    #   self-managed object storage server location.
+    #   Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
+    #   can securely connect with your location.
+    #
+    # @option params [String, StringIO, File] :server_certificate
+    #   Specifies a certificate to authenticate with an object storage system
+    #   that uses a private or self-signed certificate authority (CA). You
+    #   must specify a Base64-encoded `.pem` file (for example,
+    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The certificate
+    #   can be up to 32768 bytes (before Base64 encoding).
+    #
+    #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
+    #
+    #   Updating the certificate doesn't interfere with tasks that you have
+    #   in progress.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2899,6 +2947,7 @@ module Aws::DataSync
     #     access_key: "ObjectStorageAccessKey",
     #     secret_key: "ObjectStorageSecretKey",
     #     agent_arns: ["AgentArn"],
+    #     server_certificate: "data",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
@@ -3177,7 +3226,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.48.0'
+      context[:gem_version] = '1.50.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -153,6 +153,7 @@ module Aws::DataSync
     NfsVersion = Shapes::StringShape.new(name: 'NfsVersion')
     ObjectStorageAccessKey = Shapes::StringShape.new(name: 'ObjectStorageAccessKey')
     ObjectStorageBucketName = Shapes::StringShape.new(name: 'ObjectStorageBucketName')
+    ObjectStorageCertificate = Shapes::BlobShape.new(name: 'ObjectStorageCertificate')
     ObjectStorageSecretKey = Shapes::StringShape.new(name: 'ObjectStorageSecretKey')
     ObjectStorageServerPort = Shapes::IntegerShape.new(name: 'ObjectStorageServerPort')
     ObjectStorageServerProtocol = Shapes::StringShape.new(name: 'ObjectStorageServerProtocol')
@@ -347,6 +348,7 @@ module Aws::DataSync
     CreateLocationObjectStorageRequest.add_member(:secret_key, Shapes::ShapeRef.new(shape: ObjectStorageSecretKey, location_name: "SecretKey"))
     CreateLocationObjectStorageRequest.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, required: true, location_name: "AgentArns"))
     CreateLocationObjectStorageRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
+    CreateLocationObjectStorageRequest.add_member(:server_certificate, Shapes::ShapeRef.new(shape: ObjectStorageCertificate, location_name: "ServerCertificate"))
     CreateLocationObjectStorageRequest.struct_class = Types::CreateLocationObjectStorageRequest
 
     CreateLocationObjectStorageResponse.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationArn, location_name: "LocationArn"))
@@ -508,6 +510,7 @@ module Aws::DataSync
     DescribeLocationObjectStorageResponse.add_member(:server_protocol, Shapes::ShapeRef.new(shape: ObjectStorageServerProtocol, location_name: "ServerProtocol"))
     DescribeLocationObjectStorageResponse.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
     DescribeLocationObjectStorageResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
+    DescribeLocationObjectStorageResponse.add_member(:server_certificate, Shapes::ShapeRef.new(shape: ObjectStorageCertificate, location_name: "ServerCertificate"))
     DescribeLocationObjectStorageResponse.struct_class = Types::DescribeLocationObjectStorageResponse
 
     DescribeLocationS3Request.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationArn, required: true, location_name: "LocationArn"))
@@ -548,6 +551,7 @@ module Aws::DataSync
     DescribeTaskExecutionResponse.add_member(:bytes_written, Shapes::ShapeRef.new(shape: long, location_name: "BytesWritten"))
     DescribeTaskExecutionResponse.add_member(:bytes_transferred, Shapes::ShapeRef.new(shape: long, location_name: "BytesTransferred"))
     DescribeTaskExecutionResponse.add_member(:result, Shapes::ShapeRef.new(shape: TaskExecutionResultDetail, location_name: "Result"))
+    DescribeTaskExecutionResponse.add_member(:bytes_compressed, Shapes::ShapeRef.new(shape: long, location_name: "BytesCompressed"))
     DescribeTaskExecutionResponse.struct_class = Types::DescribeTaskExecutionResponse
 
     DescribeTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
@@ -820,6 +824,7 @@ module Aws::DataSync
     UpdateLocationObjectStorageRequest.add_member(:access_key, Shapes::ShapeRef.new(shape: ObjectStorageAccessKey, location_name: "AccessKey"))
     UpdateLocationObjectStorageRequest.add_member(:secret_key, Shapes::ShapeRef.new(shape: ObjectStorageSecretKey, location_name: "SecretKey"))
     UpdateLocationObjectStorageRequest.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
+    UpdateLocationObjectStorageRequest.add_member(:server_certificate, Shapes::ShapeRef.new(shape: ObjectStorageCertificate, location_name: "ServerCertificate"))
     UpdateLocationObjectStorageRequest.struct_class = Types::UpdateLocationObjectStorageRequest
 
     UpdateLocationObjectStorageResponse.struct_class = Types::UpdateLocationObjectStorageResponse

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

@@ -50,7 +50,7 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] task_execution_arn
-    #   The Amazon Resource Name (ARN) of the task execution to cancel.
+    #   The Amazon Resource Name (ARN) of the task execution to stop.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CancelTaskExecutionRequest AWS API Documentation
@@ -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
@@ -917,6 +927,7 @@ module Aws::DataSync
     #             value: "TagValue",
     #           },
     #         ],
+    #         server_certificate: "data",
     #       }
     #
     # @!attribute [rw] server_hostname
@@ -969,6 +980,16 @@ module Aws::DataSync
     #   location.
     #   @return [Array<Types::TagListEntry>]
     #
+    # @!attribute [rw] server_certificate
+    #   Specifies a certificate to authenticate with an object storage
+    #   system that uses a private or self-signed certificate authority
+    #   (CA). You must specify a Base64-encoded `.pem` file (for example,
+    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The
+    #   certificate can be up to 32768 bytes (before Base64 encoding).
+    #
+    #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationObjectStorageRequest AWS API Documentation
     #
     class CreateLocationObjectStorageRequest < Struct.new(
@@ -980,7 +1001,8 @@ module Aws::DataSync
       :access_key,
       :secret_key,
       :agent_arns,
-      :tags)
+      :tags,
+      :server_certificate)
       SENSITIVE = [:secret_key]
       include Aws::Structure
     end
@@ -2011,7 +2033,7 @@ module Aws::DataSync
     #
     # @!attribute [rw] access_key
     #   The access key (for example, a user name) required to authenticate
-    #   with the object storage server.
+    #   with the object storage system.
     #   @return [String]
     #
     # @!attribute [rw] server_port
@@ -2020,7 +2042,7 @@ module Aws::DataSync
     #   @return [Integer]
     #
     # @!attribute [rw] server_protocol
-    #   The protocol that your object storage server uses to communicate.
+    #   The protocol that your object storage system uses to communicate.
     #   @return [String]
     #
     # @!attribute [rw] agent_arns
@@ -2032,6 +2054,11 @@ module Aws::DataSync
     #   The time that the location was created.
     #   @return [Time]
     #
+    # @!attribute [rw] server_certificate
+    #   The self-signed certificate that DataSync uses to securely
+    #   authenticate with your object storage system.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorageResponse AWS API Documentation
     #
     class DescribeLocationObjectStorageResponse < Struct.new(
@@ -2041,7 +2068,8 @@ module Aws::DataSync
       :server_port,
       :server_protocol,
       :agent_arns,
-      :creation_time)
+      :creation_time,
+      :server_certificate)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2317,6 +2345,12 @@ module Aws::DataSync
     #   The result of the task execution.
     #   @return [Types::TaskExecutionResultDetail]
     #
+    # @!attribute [rw] bytes_compressed
+    #   The physical number of bytes transferred over the network after
+    #   compression was applied. In most cases, this number is less than
+    #   `BytesTransferred`.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionResponse AWS API Documentation
     #
     class DescribeTaskExecutionResponse < Struct.new(
@@ -2331,7 +2365,8 @@ module Aws::DataSync
       :files_transferred,
       :bytes_written,
       :bytes_transferred,
-      :result)
+      :result,
+      :bytes_compressed)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2660,7 +2695,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 +3094,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 +3127,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 +3995,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 +4023,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
@@ -4297,51 +4364,59 @@ module Aws::DataSync
     #         access_key: "ObjectStorageAccessKey",
     #         secret_key: "ObjectStorageSecretKey",
     #         agent_arns: ["AgentArn"],
+    #         server_certificate: "data",
     #       }
     #
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the self-managed object storage
-    #   server location to be updated.
+    #   Specifies the ARN of the object storage system location that you're
+    #   updating.
     #   @return [String]
     #
     # @!attribute [rw] server_port
-    #   The port that your self-managed object storage server accepts
-    #   inbound network traffic on. The server port is set by default to TCP
-    #   80 (HTTP) or TCP 443 (HTTPS). You can specify a custom port if your
-    #   self-managed object storage server requires one.
+    #   Specifies the port that your object storage server accepts inbound
+    #   network traffic on (for example, port 443).
     #   @return [Integer]
     #
     # @!attribute [rw] server_protocol
-    #   The protocol that the object storage server uses to communicate.
-    #   Valid values are `HTTP` or `HTTPS`.
+    #   Specifies the protocol that your object storage server uses to
+    #   communicate.
     #   @return [String]
     #
     # @!attribute [rw] subdirectory
-    #   The subdirectory in the self-managed object storage server that is
-    #   used to read data from.
+    #   Specifies the object prefix for your object storage server. If this
+    #   is a source location, DataSync only copies objects with this prefix.
+    #   If this is a destination location, DataSync writes all objects with
+    #   this prefix.
     #   @return [String]
     #
     # @!attribute [rw] access_key
-    #   Optional. The access key is used if credentials are required to
-    #   access the self-managed object storage server. If your object
-    #   storage requires a user name and password to authenticate, use
-    #   `AccessKey` and `SecretKey` to provide the user name and password,
-    #   respectively.
+    #   Specifies the access key (for example, a user name) if credentials
+    #   are required to authenticate with the object storage server.
     #   @return [String]
     #
     # @!attribute [rw] secret_key
-    #   Optional. The secret key is used if credentials are required to
-    #   access the self-managed object storage server. If your object
-    #   storage requires a user name and password to authenticate, use
-    #   `AccessKey` and `SecretKey` to provide the user name and password,
-    #   respectively.
+    #   Specifies the secret key (for example, a password) if credentials
+    #   are required to authenticate with the object storage server.
     #   @return [String]
     #
     # @!attribute [rw] agent_arns
-    #   The Amazon Resource Name (ARN) of the agents associated with the
-    #   self-managed object storage server location.
+    #   Specifies the Amazon Resource Names (ARNs) of the DataSync agents
+    #   that can securely connect with your location.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] server_certificate
+    #   Specifies a certificate to authenticate with an object storage
+    #   system that uses a private or self-signed certificate authority
+    #   (CA). You must specify a Base64-encoded `.pem` file (for example,
+    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The
+    #   certificate can be up to 32768 bytes (before Base64 encoding).
+    #
+    #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
+    #
+    #   Updating the certificate doesn't interfere with tasks that you have
+    #   in progress.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorageRequest AWS API Documentation
     #
     class UpdateLocationObjectStorageRequest < Struct.new(
@@ -4351,7 +4426,8 @@ module Aws::DataSync
       :subdirectory,
       :access_key,
       :secret_key,
-      :agent_arns)
+      :agent_arns,
+      :server_certificate)
       SENSITIVE = [:secret_key]
       include Aws::Structure
     end

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.50.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.50.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-28 00:00:00.000000000 Z
+date: 2022-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core