AgentsforBedrock / Paginator / ListIngestionJobs

ListIngestionJobs#

class AgentsforBedrock.Paginator.ListIngestionJobs#
paginator = client.get_paginator('list_ingestion_jobs')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from AgentsforBedrock.Client.list_ingestion_jobs().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    dataSourceId='string',
    filters=[
        {
            'attribute': 'STATUS',
            'operator': 'EQ',
            'values': [
                'string',
            ]
        },
    ],
    knowledgeBaseId='string',
    sortBy={
        'attribute': 'STATUS'|'STARTED_AT',
        'order': 'ASCENDING'|'DESCENDING'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • dataSourceId (string) –

    [REQUIRED]

    The unique identifier of the data source for which to return ingestion jobs.

  • filters (list) –

    Contains a definition of a filter for which to filter the results.

    • (dict) –

      Defines a filter by which to filter the results.

      • attribute (string) – [REQUIRED]

        The attribute by which to filter the results.

      • operator (string) – [REQUIRED]

        The operation to carry out between the attribute and the values.

      • values (list) – [REQUIRED]

        A list of values for the attribute.

        • (string) –

  • knowledgeBaseId (string) –

    [REQUIRED]

    The unique identifier of the knowledge base for which to return ingestion jobs.

  • sortBy (dict) –

    Contains details about how to sort the results.

    • attribute (string) – [REQUIRED]

      The attribute by which to sort the results.

    • order (string) – [REQUIRED]

      The order by which to sort the results.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'ingestionJobSummaries': [
        {
            'dataSourceId': 'string',
            'description': 'string',
            'ingestionJobId': 'string',
            'knowledgeBaseId': 'string',
            'startedAt': datetime(2015, 1, 1),
            'statistics': {
                'numberOfDocumentsDeleted': 123,
                'numberOfDocumentsFailed': 123,
                'numberOfDocumentsScanned': 123,
                'numberOfMetadataDocumentsModified': 123,
                'numberOfMetadataDocumentsScanned': 123,
                'numberOfModifiedDocumentsIndexed': 123,
                'numberOfNewDocumentsIndexed': 123
            },
            'status': 'STARTING'|'IN_PROGRESS'|'COMPLETE'|'FAILED',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • ingestionJobSummaries (list) –

      A list of objects, each of which contains information about an ingestion job.

      • (dict) –

        Contains details about an ingestion job.

        • dataSourceId (string) –

          The unique identifier of the data source in the ingestion job.

        • description (string) –

          The description of the ingestion job.

        • ingestionJobId (string) –

          The unique identifier of the ingestion job.

        • knowledgeBaseId (string) –

          The unique identifier of the knowledge base to which the data source is added.

        • startedAt (datetime) –

          The time at which the ingestion job was started.

        • statistics (dict) –

          Contains statistics for the ingestion job.

          • numberOfDocumentsDeleted (integer) –

            The number of source documents that was deleted.

          • numberOfDocumentsFailed (integer) –

            The number of source documents that failed to be ingested.

          • numberOfDocumentsScanned (integer) –

            The total number of source documents that were scanned. Includes new, updated, and unchanged documents.

          • numberOfMetadataDocumentsModified (integer) –

            The number of metadata files that were updated or deleted.

          • numberOfMetadataDocumentsScanned (integer) –

            The total number of metadata files that were scanned. Includes new, updated, and unchanged files.

          • numberOfModifiedDocumentsIndexed (integer) –

            The number of modified source documents in the data source that were successfully indexed.

          • numberOfNewDocumentsIndexed (integer) –

            The number of new source documents in the data source that were successfully indexed.

        • status (string) –

          The status of the ingestion job.

        • updatedAt (datetime) –

          The time at which the ingestion job was last updated.

    • NextToken (string) –

      A token to resume pagination.