QBusiness / Client / list_retrievers

list_retrievers#

QBusiness.Client.list_retrievers(**kwargs)#

Lists the retriever used by an Amazon Q Business application.

See also: AWS API Documentation

Request Syntax

response = client.list_retrievers(
    applicationId='string',
    nextToken='string',
    maxResults=123
)
Parameters:
  • applicationId (string) –

    [REQUIRED]

    The identifier of the Amazon Q Business application using the retriever.

  • nextToken (string) – If the number of retrievers returned exceeds maxResults, Amazon Q Business returns a next token as a pagination token to retrieve the next set of retrievers.

  • maxResults (integer) – The maximum number of retrievers returned.

Return type:

dict

Returns:

Response Syntax

{
    'retrievers': [
        {
            'applicationId': 'string',
            'retrieverId': 'string',
            'type': 'NATIVE_INDEX'|'KENDRA_INDEX',
            'status': 'CREATING'|'ACTIVE'|'FAILED',
            'displayName': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • retrievers (list) –

      An array of summary information for one or more retrievers.

      • (dict) –

        Summary information for the retriever used for your Amazon Q Business application.

        • applicationId (string) –

          The identifier of the Amazon Q Business application using the retriever.

        • retrieverId (string) –

          The identifier of the retriever used by your Amazon Q Business application.

        • type (string) –

          The type of your retriever.

        • status (string) –

          The status of your retriever.

        • displayName (string) –

          The name of your retriever.

    • nextToken (string) –

      If the response is truncated, Amazon Q Business returns this token, which you can use in a later request to list the next set of retrievers.

Exceptions

  • QBusiness.Client.exceptions.ResourceNotFoundException

  • QBusiness.Client.exceptions.InternalServerException

  • QBusiness.Client.exceptions.ThrottlingException

  • QBusiness.Client.exceptions.ValidationException

  • QBusiness.Client.exceptions.AccessDeniedException