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).

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

SNS.Client.exceptions.InvalidParameterException
SNS.Client.exceptions.InternalErrorException
SNS.Client.exceptions.AuthorizationErrorException