SNS / Client / list_topics

list_topics#

SNS.Client.list_topics(**kwargs)#

Returns a list of the requester’s topics. Each call returns a limited list of topics, up to 100. If there are more topics, a NextToken is also returned. Use the NextToken parameter in a new ListTopics call to get further results.

This action is throttled at 30 transactions per second (TPS).

See also: AWS API Documentation

Request Syntax

response = client.list_topics(
    NextToken='string'
)
Parameters:

NextToken (string) – Token returned by the previous ListTopics request.

Return type:

dict

Returns:

Response Syntax

{
    'Topics': [
        {
            'TopicArn': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    Response for ListTopics action.

    • Topics (list) –

      A list of topic ARNs.

      • (dict) –

        A wrapper type for the topic’s Amazon Resource Name (ARN). To retrieve a topic’s attributes, use GetTopicAttributes.

        • TopicArn (string) –

          The topic’s ARN.

    • NextToken (string) –

      Token to pass along to the next ListTopics request. This element is returned if there are additional topics to retrieve.

Exceptions