QBusiness / Client / list_retrievers

list_retrievers#

QBusiness.Client.list_retrievers(**kwargs)#

Lists the retriever used by an Amazon Q application.

Request Syntax

response = client.list_retrievers(
    applicationId='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

applicationId (string) –
[REQUIRED]

The identifier of the Amazon Q application using the retriever.
maxResults (integer) – The maximum number of retrievers returned.
nextToken (string) – If the number of retrievers returned exceeds maxResults, Amazon Q returns a next token as a pagination token to retrieve the next set of retrievers.

Return type:

dict

Returns:

Response Syntax

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

Response Structure

(dict) –
- nextToken (string) –
  
  If the response is truncated, Amazon Q returns this token, which you can use in a later request to list the next set of retrievers.
- retrievers (list) –
  
  An array of summary information for one or more retrievers.
  - (dict) –
    
    Summary information for the retriever used for your Amazon Q application.
    - applicationId (string) –
      
      The identifier of the Amazon Q application using the retriever.
    - displayName (string) –
      
      The name of your retriever.
    - retrieverId (string) –
      
      The identifier of the retriever used by your Amazon Q application.
    - status (string) –
      
      The status of your retriever.
    - type (string) –
      
      The type of your retriever.

Exceptions

QBusiness.Client.exceptions.ResourceNotFoundException
QBusiness.Client.exceptions.InternalServerException
QBusiness.Client.exceptions.ThrottlingException
QBusiness.Client.exceptions.ValidationException
QBusiness.Client.exceptions.AccessDeniedException