Skip to content

Sns  >  Operations  >  list_topics

list_topics

Operation

list_topics async

list_topics(input: ListTopicsInput, plugins: list[Plugin] | None = None) -> ListTopicsOutput

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

Parameters:

Name Type Description Default
input ListTopicsInput

An instance of ListTopicsInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
ListTopicsOutput

An instance of ListTopicsOutput.

Input

ListTopicsInput dataclass

Dataclass for ListTopicsInput structure.

Attributes

next_token class-attribute instance-attribute
next_token: str | None = None

Token returned by the previous ListTopics request.

Output

ListTopicsOutput dataclass

Response for ListTopics action.

Attributes

next_token class-attribute instance-attribute
next_token: str | None = None

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

topics class-attribute instance-attribute
topics: list[Topic] | None = None

A list of topic ARNs.