---
title: "POST /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs"
method: POST
path: "/v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs"
---

# POST /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs

`POST /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs`

Start the run of the specified data source in Amazon DataZone.

## Path parameters

- `domainIdentifier` string, required
- `dataSourceIdentifier` string, required

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

## Response `200`

Success

- StartDataSourceRunOutput
  - `domainId` string, required — The identifier of the Amazon DataZone domain in which to start a data source run.
  - `dataSourceId` string, required — The identifier of the data source.
  - `id` string, required — The identifier of the data source run.
  - `projectId` string, required — The identifier of the project.
  - `status` 'REQUESTED' | 'RUNNING' | 'FAILED' | 'PARTIALLY_SUCCEEDED' | 'SUCCESS', required — The status of the data source run.
  - `type` 'PRIORITIZED' | 'SCHEDULED', required — The type of the data source run.
  - `dataSourceConfigurationSnapshot` string — The configuration snapshot of the data source that is being run.
  - `runStatisticsForAssets` object — Specifies run statistics for assets.
    - `added` integer — The <code>added</code> statistic for the data source run.
    - `updated` integer — The <code>updated</code> statistic for the data source run.
    - `unchanged` integer — The <code>unchanged</code> statistic for the data source run.
    - `skipped` integer — The <code>skipped</code> statistic for the data source run.
    - `failed` integer — The <code>failed</code> statistic for the data source run.
  - `errorMessage` object — Specifies the error message that is returned if the operation cannot be successfully completed.
    - `errorType` 'ACCESS_DENIED_EXCEPTION' | 'CONFLICT_EXCEPTION' | 'INTERNAL_SERVER_EXCEPTION' | 'RESOURCE_NOT_FOUND_EXCEPTION' | 'SERVICE_QUOTA_EXCEEDED_EXCEPTION' | 'THROTTLING_EXCEPTION' | 'VALIDATION_EXCEPTION', required — The type of the error message that is returned if the operation cannot be successfully completed.
    - `errorDetail` string — The details of the error message that is returned if the operation cannot be successfully completed.
  - `createdAt` string, date-time, required — The timestamp of when data source run was created.
  - `updatedAt` string, date-time, required — The timestamp of when the data source run was updated.
  - `startedAt` string, date-time — The timestamp of when the data source run was started.
  - `stoppedAt` string, date-time — The timestamp of when the data source run was stopped.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/revisions/055599054b53/schema)