list_bots

list_bots(**kwargs)

This API is in preview release for Amazon Connect and is subject to change.

For the specified version of Amazon Lex, returns a paginated list of all the Amazon Lex bots currently associated with the instance. Use this API to returns both Amazon Lex V1 and V2 bots.

See also: AWS API Documentation

Request Syntax

response = client.list_bots(
    InstanceId='string',
    NextToken='string',
    MaxResults=123,
    LexVersion='V1'|'V2'
)
Parameters
  • InstanceId (string) --

    [REQUIRED]

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • NextToken (string) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
  • MaxResults (integer) -- The maximum number of results to return per page.
  • LexVersion (string) --

    [REQUIRED]

    The version of Amazon Lex or Amazon Lex V2.

Return type

dict

Returns

Response Syntax

{
    'LexBots': [
        {
            'LexBot': {
                'Name': 'string',
                'LexRegion': 'string'
            },
            'LexV2Bot': {
                'AliasArn': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • LexBots (list) --

      The names and Amazon Web Services Regions of the Amazon Lex or Amazon Lex V2 bots associated with the specified instance.

      • (dict) --

        Configuration information of an Amazon Lex or Amazon Lex V2 bot.

        • LexBot (dict) --

          Configuration information of an Amazon Lex bot.

          • Name (string) --

            The name of the Amazon Lex bot.

          • LexRegion (string) --

            The Amazon Web Services Region where the Amazon Lex bot was created.

        • LexV2Bot (dict) --

          Configuration information of an Amazon Lex V2 bot.

          • AliasArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Lex V2 bot.

    • NextToken (string) --

      If there are additional results, this is the token for the next set of results.

Exceptions

  • Connect.Client.exceptions.ResourceNotFoundException
  • Connect.Client.exceptions.InternalServiceException
  • Connect.Client.exceptions.InvalidRequestException
  • Connect.Client.exceptions.ThrottlingException