Starting an Amazon DataSync task with the Amazon CLI - Amazon DataSync
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Starting an Amazon DataSync task with the Amazon CLI

When a task execution starts, its status changes from Launching to Preparing within about 10 minutes. The time that the task execution takes to move through its other phases is proportional to the size of your transfer. For information about task execution phases, see Task execution.

Use the following command to start a task execution.

aws datasync start-task-execution \ --task-arn 'arn:aws-cn:datasync:region:account-id:task/task-id'

The command returns a task execution Amazon Resource Name (ARN) similar to the one shown following.

{ "TaskExecutionArn": "arn:aws-cn:datasync:us-east-1:209870788375:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" }

You can override the task's options by specifying different options for the current execution, as shown in the example following. For a description of these options, see Options.

aws datasync start-task-execution [...] \ --override-options \ --VerifyMode=NONE,OverwriteMode=NEVER,PosixPermissions=NONE

When you run a task, you can optionally configure the task to include specific files, folders, and objects to transfer. For more information, see Filtering data transferred by Amazon DataSync.


Each agent can run a single task at a time.