View Source AWS.DataSync (aws-elixir v0.13.1)
DataSync
DataSync is a managed data transfer service that makes it simpler for you to automate moving data between on-premises storage and Amazon Simple Storage Service (Amazon S3) or Amazon Elastic File System (Amazon EFS).
This API interface reference for DataSync contains documentation for a programming interface that you can use to manage DataSync.
Link to this section Summary
Functions
Cancels execution of a task.
Activates an DataSync agent that you have deployed on your host.
Creates an endpoint for an Amazon EFS file system that DataSync can access for a transfer.
Creates an endpoint for an Amazon FSx for Lustre file system.
Creates an endpoint for an Amazon FSx for NetApp ONTAP file system that DataSync can access for a transfer.
Creates an endpoint for an Amazon FSx for OpenZFS file system.
Creates an endpoint for an Amazon FSx for Windows File Server file system.
Creates an endpoint for a Hadoop Distributed File System (HDFS).
Defines a file system on a Network File System (NFS) server that can be read from or written to.
Creates an endpoint for an object storage system that DataSync can access for a transfer.
Creates an endpoint for an Amazon S3 bucket.
Defines a file system on a Server Message Block (SMB) server that can be read from or written to.
Configures a task, which defines where and how DataSync transfers your data.
Deletes an agent.
Deletes the configuration of a location used by DataSync.
Deletes a task.
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running or not) for an agent.
Returns metadata about your DataSync location for an Amazon EFS file system.
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 NetApp ONTAP file system is configured.
Returns metadata about an Amazon FSx for OpenZFS location, such as information about its path.
Returns metadata about an Amazon FSx for Windows File Server location, such as information about its path.
Returns metadata, such as the authentication information about the Hadoop Distributed File System (HDFS) location.
Returns metadata, such as the path information, about an NFS location.
Returns metadata about your DataSync location for an object storage system.
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
Returns metadata, such as the path and user information about an SMB location.
Returns metadata about a task.
Returns detailed metadata about a task that is being executed.
Returns a list of agents owned by an Amazon Web Services account in the Amazon Web Services Region specified in the request.
Returns a list of source and destination locations.
Returns all the tags associated with a specified resource.
Returns a list of executed tasks.
Returns a list of the DataSync tasks you created.
Starts a specific invocation of a task.
Applies a key-value pair to an Amazon Web Services resource.
Removes a tag from an Amazon Web Services resource.
Updates the name of an agent.
Updates some parameters of a previously created location for a Hadoop Distributed File System cluster.
Updates some of the parameters of a previously created location for Network File System (NFS) access.
Updates some of the parameters of a previously created location for self-managed object storage server access.
Updates some of the parameters of a previously created location for Server Message Block (SMB) file system access.
Updates the metadata associated with a task.
Updates execution of a task.
Link to this section Functions
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.
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.
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 over the public internet.
You can use an agent for more than one location. If a task uses multiple agents, all of them need to have status AVAILABLE for the task to run. If you use multiple agents for a source location, the status of all the agents must be AVAILABLE for the task to run.
Agents are automatically updated by Amazon Web Services on a regular basis, using a mechanism that ensures minimal interruption to your tasks.
Creates an endpoint for an Amazon EFS file system that DataSync can access for a transfer.
For more information, see Creating a location for Amazon EFS.
Creates an endpoint for an Amazon FSx for Lustre file system.
Creates an endpoint for an Amazon FSx for NetApp ONTAP file system that DataSync can access for a transfer.
For more information, see Creating a location for FSx for ONTAP.
Creates an endpoint for an Amazon FSx for OpenZFS file system.
Creates an endpoint for an Amazon FSx for Windows File Server file system.
Creates an endpoint for a Hadoop Distributed File System (HDFS).
Defines a file system on a Network File System (NFS) server that can be read from or written to.
Creates an endpoint for an object storage system that DataSync can access for a transfer.
For more information, see Creating a location for object storage.
Creates an endpoint for an Amazon S3 bucket.
For more information, see Create an Amazon S3 location in the DataSync User Guide.
Defines a file system on a Server Message Block (SMB) server that can be read from or written to.
Configures a task, which defines where and how DataSync transfers your data.
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 your locations must reside in the Region where you're using DataSync.
For more information, see the following topics:
Deletes an agent.
To specify which agent to delete, use the Amazon Resource Name (ARN) of the agent in your request. The operation disassociates the agent from your Amazon Web Services account. However, it doesn't delete the agent virtual machine (VM) from your on-premises environment.
Deletes the configuration of a location used by DataSync.
Deletes a task.
Returns metadata such as the name, the network interfaces, and the status (that is, whether the agent is running or not) for an agent.
To specify which agent to describe, use the Amazon Resource Name (ARN) of the agent in your request.
Returns metadata about your DataSync location for an Amazon EFS file system.
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 NetApp ONTAP file system is configured.
Returns metadata about an Amazon FSx for OpenZFS location, such as information about its path.
Returns metadata about an Amazon FSx for Windows File Server location, such as information about its path.
Returns metadata, such as the authentication information about the Hadoop Distributed File System (HDFS) location.
Returns metadata, such as the path information, about an NFS location.
Returns metadata about your DataSync location for an object storage system.
Returns metadata, such as bucket name, about an Amazon S3 bucket location.
Returns metadata, such as the path and user information about an SMB location.
Returns metadata about a task.
Returns detailed metadata about a task that is being executed.
Returns a list of agents owned by an Amazon Web Services account in the Amazon Web Services Region specified in the request.
The returned list is ordered by agent Amazon Resource Name (ARN).
By default, this operation returns a maximum of 100 agents. This operation supports pagination that enables you to optionally reduce the number of agents returned in a response.
If you have more agents than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a marker that you can specify in your next request to fetch the next page of agents.
Returns a list of source and destination locations.
If you have more locations than are returned in a response (that is, the response returns only a truncated list of your agents), the response contains a token that you can specify in your next request to fetch the next page of locations.
Returns all the tags associated with a specified resource.
Returns a list of executed tasks.
Returns a list of the DataSync tasks you created.
Starts a specific invocation of a task.
A TaskExecution
value represents an individual run of a task. Each task can
have at most one TaskExecution
at a time.
TaskExecution has the following transition phases: INITIALIZING | PREPARING | |
TRANSFERRING | VERIFYING | SUCCESS/FAILURE. |
For detailed information, see the Task Execution section in the Components and Terminology topic in the DataSync User Guide.
Applies a key-value pair to an Amazon Web Services resource.
Removes a tag from an Amazon Web Services resource.
Updates the name of an agent.
Updates some parameters of a previously created location for a Hadoop Distributed File System cluster.
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.
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.
Updates some of the parameters of a previously created location for Server Message Block (SMB) file system access.
For information about creating an SMB location, see Creating a location for SMB.
Updates the metadata associated with a task.
Updates execution of a task.
You can modify bandwidth throttling for a task execution that is running or queued. For more information, see Adjusting Bandwidth Throttling for a Task Execution.
The only Option
that can be modified by UpdateTaskExecution
is [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond)
.