Starting a task to transfer your data
Once you create your AWS DataSync transfer task, you can start moving data. Each run of a task is called a task execution. For information about what happens during a task execution, see How DataSync transfers files, objects, and directories.
Important
If you're planning to transfer data to or from an Amazon S3 location, review how DataSync can affect your S3 request charges and the DataSync pricing page
Starting your task
Once you've created your task, you can begin moving data right away.
Open the AWS DataSync console at https://console.aws.amazon.com/datasync/
. -
In the left navigation pane, expand Data transfer, then choose Tasks.
-
Choose the task that you want to run.
Make sure that the task has an Available status. You also can select multiple tasks.
-
Choose Actions and then choose one of the following options:
-
Start – Runs the task (or tasks if you selected more than one).
-
Start with overriding options – Allows you to modify some of your task settings before you begin moving data. When you're ready, choose Start.
-
-
Choose See execution details to view details about the running task execution.
To start your DataSync task, you just need to specify the Amazon Resource Name (ARN) of
the task you want to run. Here's an example start-task-execution
command:
aws datasync start-task-execution \ --task-arn 'arn:aws:datasync:region:account-id:task/task-id'
The following example starts a task with a few settings that are different than the task's default settings:
aws datasync start-task-execution \ --override-options VerifyMode=NONE,OverwriteMode=NEVER,PosixPermissions=NONE
The command returns an ARN for your task execution similar to the following example:
{ "TaskExecutionArn": "arn:aws:datasync:us-east-1:209870788375:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" }
Note
Each agent can run a single task at a time.
You can start your task by using the StartTaskExecution operation. Use the DescribeTaskExecution operation to get details about the running task execution.
Once started, you can check the task execution's status as DataSync copies your data. You also can throttle the task execution's bandwidth if needed.
Task execution statuses
When you start a DataSync task, you might see these statuses. (Task statuses are different than task execution statuses.)
| Console status | API status | Description |
|---|---|---|
|
Queueing |
|
Another task execution is running and using the same DataSync agent. For more information, see Knowing when your task is queued. |
|
Launching |
|
DataSync is initializing the task execution. This status usually goes quickly but can take up to a few minutes. |
|
Preparing |
|
DataSync is determining what data to transfer. Preparation can take just minutes, a few hours, or even longer depending on the number of files, objects, or directories in both locations and how you configure your task. How preparation works also depends on your task mode. For more information, see How DataSync prepares your data transfer. |
|
Transferring |
|
DataSync is performing the actual data transfer. |
|
Verifying |
|
DataSync is verifying the integrity of your data at the end of the transfer. |
|
Success |
|
The task execution succeeded. |
|
Cancelling |
|
The task execution is in the process of being cancelled. |
|
Error |
|
The task execution failed. |
Knowing when your task is queued
When running multiple tasks (for example, you're transferring a large dataset), DataSync might queue the tasks to run in a series (first in, first out). Some examples of when this happens include:
In each example, the queued tasks don't start until the task ahead of them finishes.
Cancelling your task execution
You can stop any running or queued DataSync task execution.
To cancel a task execution by using the console
Open the AWS DataSync console at https://console.aws.amazon.com/datasync/
. -
In the left navigation pane, expand Data transfer, then choose Tasks.
-
Select the Task ID for the running task that you want to monitor.
The task status should be Running.
-
Choose History to view the task's executions.
-
Select the task execution that you want to stop, and then choose Stop.
-
In the dialog box, choose Stop.
To cancel a running or queued task by using the DataSync API, see CancelTaskExecution.
