OpenSearchServiceServerless / Client / list_ingestion_jobs

list_ingestion_jobs

OpenSearchServiceServerless.Client.list_ingestion_jobs(**kwargs)

Returns a list of ingestion jobs in a collection.

See also: AWS API Documentation

Request Syntax

response = client.list_ingestion_jobs(
    collectionId='string',
    nextToken='string',
    maxResults=123
)
Parameters:

  • collectionId (string) –

    [REQUIRED]

    The unique identifier of the collection to list ingestion jobs for.

  • nextToken (string) – If your initial ListIngestionJobs operation returns a nextToken, you can include the returned nextToken in subsequent ListIngestionJobs operations, which returns results in the next page.

  • maxResults (integer) –

    The maximum number of results to return. Valid values are 1–100. If you don’t specify a value, the default is 100. You can use nextToken to get the next page of results.

    A response can contain fewer results than maxResults, or no results, and still include a nextToken. To retrieve all results, continue to make the call with the returned nextToken until no nextToken is returned.

Return type:

dict

Returns:

Response Syntax

{
    'ingestionJobSummaries': [
        {
            'ingestionJobId': 'string',
            'arn': 'string',
            'ingestionJobName': 'string',
            'indexName': 'string',
            'status': 'CREATING'|'ACTIVE'|'COMPLETED'|'CANCELLING'|'CANCELLED'|'FAILED'|'CREATE_FAILED'|'CANCEL_FAILED',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • ingestionJobSummaries (list) –

      Summary information about each ingestion job.

      • (dict) –

        Summary information about an ingestion job.

        • ingestionJobId (string) –

          The unique identifier of the ingestion job.

        • arn (string) –

          The Amazon Resource Name (ARN) of the ingestion job.

        • ingestionJobName (string) –

          The name of the ingestion job.

        • indexName (string) –

          The name of the index that documents are ingested into.

        • status (string) –

          The current lifecycle status of the ingestion job.

        • createdAt (datetime) –

          The date and time when the ingestion job was created.

        • updatedAt (datetime) –

          The date and time when the ingestion job was last updated.

    • nextToken (string) –

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

Exceptions