Sns  >  Operations  >  list_subscriptions_by_topic

list_subscriptions_by_topic

Operation

list_subscriptions_by_topic async

list_subscriptions_by_topic(input: ListSubscriptionsByTopicInput, plugins: list[Plugin] | None = None) -> ListSubscriptionsByTopicOutput

Returns a list of the subscriptions to a specific topic. Each call returns a limited list of subscriptions, up to 100. If there are more subscriptions, a NextToken is also returned. Use the NextToken parameter in a new ListSubscriptionsByTopic call to get further results.

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

Parameters:

Name	Type	Description	Default
input	ListSubscriptionsByTopicInput	An instance of ListSubscriptionsByTopicInput.	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
ListSubscriptionsByTopicOutput	An instance of ListSubscriptionsByTopicOutput.

Input

ListSubscriptionsByTopicInput dataclass

Input for ListSubscriptionsByTopic action.

Attributes

next_token class-attribute instance-attribute

next_token: str | None = None

Token returned by the previous ListSubscriptionsByTopic request.

topic_arn class-attribute instance-attribute

topic_arn: str | None = None

The ARN of the topic for which you wish to find subscriptions.

Output

ListSubscriptionsByTopicOutput dataclass

Response for ListSubscriptionsByTopic action.

Attributes

next_token class-attribute instance-attribute

next_token: str | None = None

Token to pass along to the next ListSubscriptionsByTopic request. This element is returned if there are more subscriptions to retrieve.

subscriptions class-attribute instance-attribute

subscriptions: list[Subscription] | None = None

A list of subscriptions.