Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_batch_load_tasks

list_batch_load_tasks(**kwargs)

Provides a list of batch load tasks, along with the name, status, when the task is resumable until, and other details. See code sample for details.

See also: AWS API Documentation

Request Syntax

response = client.list_batch_load_tasks(
    NextToken='string',
    MaxResults=123,
    TaskStatus='CREATED'|'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'PROGRESS_STOPPED'|'PENDING_RESUME'
)
Parameters
  • NextToken (string) -- A token to specify where to start paginating. This is the NextToken from a previously truncated response.
  • MaxResults (integer) -- The total number of items to return in the output. If the total number of items available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
  • TaskStatus (string) -- Status of the batch load task.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'BatchLoadTasks': [
        {
            'TaskId': 'string',
            'TaskStatus': 'CREATED'|'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'PROGRESS_STOPPED'|'PENDING_RESUME',
            'DatabaseName': 'string',
            'TableName': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'LastUpdatedTime': datetime(2015, 1, 1),
            'ResumableUntil': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      A token to specify where to start paginating. Provide the next ListBatchLoadTasksRequest.

    • BatchLoadTasks (list) --

      A list of batch load task details.

      • (dict) --

        Details about a batch load task.

        • TaskId (string) --

          The ID of the batch load task.

        • TaskStatus (string) --

          Status of the batch load task.

        • DatabaseName (string) --

          Database name for the database into which a batch load task loads data.

        • TableName (string) --

          Table name for the table into which a batch load task loads data.

        • CreationTime (datetime) --

          The time when the Timestream batch load task was created.

        • LastUpdatedTime (datetime) --

          The time when the Timestream batch load task was last updated.

        • ResumableUntil (datetime) --

Exceptions

  • TimestreamWrite.Client.exceptions.InternalServerException
  • TimestreamWrite.Client.exceptions.AccessDeniedException
  • TimestreamWrite.Client.exceptions.ThrottlingException
  • TimestreamWrite.Client.exceptions.ValidationException
  • TimestreamWrite.Client.exceptions.InvalidEndpointException