Working with DataSync discovery jobs - Amazon DataSync
Starting a discovery jobStopping a discovery job
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).

Tip

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 console, you can run a discovery job for as short as one day. To run a discovery job for less than one day, use the Amazon CLI.

  1. Open the Amazon DataSync console at https://console.amazonaws.cn/datasync/.

  2. In the left navigation pane, choose Discovery, and then choose the storage system that you want to run the discovery job on.

  3. Choose Actions, then Start.

  4. For Duration, choose how long that you want the discovery job to run.

  5. Choose Start discovery job.

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. Open the Amazon DataSync console at https://console.amazonaws.cn/datasync/.

  2. In the left navigation pane, choose Discovery, and then choose the storage system that you're running a discovery job on.

  3. Choose Actions, then Stop (keep data).

  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.