DataZone / Client / list_data_source_runs

list_data_source_runs

DataZone.Client.list_data_source_runs(**kwargs)

Lists data source runs in Amazon DataZone.

See also: AWS API Documentation

Request Syntax

response = client.list_data_source_runs(
    dataSourceIdentifier='string',
    domainIdentifier='string',
    maxResults=123,
    nextToken='string',
    status='REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS'
)

Parameters:

• dataSourceIdentifier (string) –

  [REQUIRED]

  The identifier of the data source.

• domainIdentifier (string) –

  [REQUIRED]

  The identifier of the Amazon DataZone domain in which to invoke the ListDataSourceRuns action.

• maxResults (integer) – The maximum number of runs to return in a single call to ListDataSourceRuns. When the number of runs to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListDataSourceRuns to list the next set of runs.

• nextToken (string) – When the number of runs is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of runs, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDataSourceRuns to list the next set of runs.

• status (string) – The status of the data source.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'dataSourceId': 'string',
            'errorMessage': {
                'errorDetail': 'string',
                'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION'
            },
            'id': 'string',
            'lineageSummary': {
                'importStatus': 'IN_PROGRESS'|'SUCCESS'|'FAILED'|'PARTIALLY_SUCCEEDED'
            },
            'projectId': 'string',
            'runStatisticsForAssets': {
                'added': 123,
                'failed': 123,
                'skipped': 123,
                'unchanged': 123,
                'updated': 123
            },
            'startedAt': datetime(2015, 1, 1),
            'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
            'stoppedAt': datetime(2015, 1, 1),
            'type': 'PRIORITIZED'|'SCHEDULED',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • items (list) –

    The results of the ListDataSourceRuns action.

    • (dict) –

      The details of a data source run.

      • createdAt (datetime) –

        The timestamp of when a data source run was created.

      • dataSourceId (string) –

        The identifier of the data source of the data source run.

      • errorMessage (dict) –

        The details 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.

        • errorType (string) –

          The type of the error message that is returned if the operation cannot be successfully completed.

      • id (string) –

        The identifier of the data source run.

      • lineageSummary (dict) –

        The run lineage summary of a data source.

        • importStatus (string) –

          The import status that’s part of the run lineage summary of a data source.

      • projectId (string) –

        The project ID of the data source run.

      • runStatisticsForAssets (dict) –

        The asset statistics from the data source run.

        • added (integer) –

          The added statistic for the data source run.

        • failed (integer) –

          The failed statistic for the data source run.

        • skipped (integer) –

          The skipped statistic for the data source run.

        • unchanged (integer) –

          The unchanged statistic for the data source run.

        • updated (integer) –

          The updated statistic for the data source run.

      • startedAt (datetime) –

        The timestamp of when a data source run was started.

      • status (string) –

        The status of the data source run.

      • stoppedAt (datetime) –

        The timestamp of when a data source run was stopped.

      • type (string) –

        The type of the data source run.

      • updatedAt (datetime) –

        The timestamp of when a data source run was updated.

  • nextToken (string) –

    When the number of runs is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of runs, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListDataSourceRuns to list the next set of runs.

Exceptions

• DataZone.Client.exceptions.InternalServerException

• DataZone.Client.exceptions.ResourceNotFoundException

• DataZone.Client.exceptions.AccessDeniedException

• DataZone.Client.exceptions.ThrottlingException

• DataZone.Client.exceptions.ServiceQuotaExceededException

• DataZone.Client.exceptions.ConflictException

• DataZone.Client.exceptions.ValidationException

• DataZone.Client.exceptions.UnauthorizedException