Starting your task Task execution statuses Knowing when your task is queued Cancelling your task execution

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 atask 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 theDataSync pricing page before you begin.

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, expandData transfer, then chooseTasks.
Choose the task that you want to run.
Make sure that the task has anAvailable status. You also can select multiple tasks.
ChooseActions 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, chooseStart.
ChooseSee 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 examplestart-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 theDescribeTaskExecution operation to get details about the running task execution.

Once started, you cancheck the task execution's status as DataSync copies your data. You also canthrottle 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	`QUEUED`	Another task execution is running and using the same DataSync agent. For more information, seeKnowing when your task is queued.
Launching	`LAUNCHING`	DataSync is initializing the task execution. This status usually goes quickly but can take up to a few minutes.
Preparing	`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, seeHow DataSync prepares your data transfer.
Transferring	`TRANSFERRING`	DataSync is performing the actual data transfer.
Verifying	`VERIFYING`	DataSync is verifying the integrity of your data at the end of the transfer.
Success	`SUCCESS`	The task execution succeeded.
Cancelling	`CANCELLING`	The task execution is in the process of being cancelled.
Error	`ERROR`	The task execution failed.

Knowing when your task is queued

When running multiple tasks (for example, you'retransferring a large dataset), DataSync might queue the tasks to run in a series (first in, first out). Some examples of when this happens include:

You run different tasks that use the same DataSync agent. While you can use the same agent for multiple tasks, an agent can only run one task at a time.
A task execution is in progress and you start additional executions of the same task using differentfilters ormanifests.

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 athttps://console.aws.amazon.com/datasync/.
In the left navigation pane, expandData transfer, then chooseTasks.
Select theTask ID for the running task that you want to monitor.
The task status should beRunning.
ChooseHistory to view the task's executions.
Select the task execution that you want to stop, and then chooseStop.
In the dialog box, chooseStop.