list_topics

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

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