Working with DataSync discovery jobs - 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 (PDF).

Working with DataSync discovery jobs

After you deploy your Amazon DataSync agent and add your on-premises storage system to DataSync Discovery, you can run discovery jobs to collect information about the system and get Amazon migration recommendations.

Starting a discovery job

You can run a discovery job for up to 31 days. A storage system can have only one active discovery job at a time. The information that a discovery job collects is available for up to 60 days following the end of the job (unless you remove the related storage system from DataSync Discovery before that).


DataSync Discovery can provide more accurate recommendations the longer your discovery job runs. We recommend running a discovery job for at least 14 days.

With the Amazon Command Line Interface (Amazon CLI), you can run a discovery job for as short as 1 hour.

  1. Copy the following start-discovery-job command:

    aws datasync start-discovery-job \ --storage-system-arn "your-storage-system-arn" \ --collection-duration-minutes discovery-job-duration
  2. Specify the following parameters in the command:

    • --storage-system-arn – Specify the Amazon Resource Name (ARN) of the on-premises storage system that you added to DataSync Discovery.

    • --collection-duration-minutes – Specify how long that you want the discovery job to run in minutes. Enter a value between 60 (1 hour) and 44640 (31 days).

  3. Run the start-discovery-job command.

    You get a response that shows the discovery job that you just started.

    { "DiscoveryJobArn": "arn:aws-cn:datasync:us-east-1:123456789012:system/storage-system-abcdef01234567890/job/discovery-job-12345678-90ab-cdef-0abc-021345abcdef6" }

Shortly after starting the discovery job, you can begin looking at the information that the job collects (including storage system capacity and usage).

Stopping a discovery job

Stop a discovery job at any time. You can still get recommendations for a stopped job.

  1. Copy the following stop-discovery-job command:

    aws datasync stop-discovery-job --discovery-job-arn "your-discovery-job-arn"
  2. For --discovery-job-arn, specify the ARN of the discovery job that's currently running.

  3. Run the stop-discovery-job command.

    If successful, you get an HTTP 200 response with an empty HTTP body.