Skip to content

Sns  >  Operations  >  list_subscriptions

list_subscriptions

Operation

list_subscriptions async

list_subscriptions(input: ListSubscriptionsInput, plugins: list[Plugin] | None = None) -> ListSubscriptionsOutput

Returns a list of the requester's subscriptions. 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 ListSubscriptions call to get further results.

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

Parameters:

Name Type Description Default
input ListSubscriptionsInput

An instance of ListSubscriptionsInput.

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
ListSubscriptionsOutput

An instance of ListSubscriptionsOutput.

Input

ListSubscriptionsInput dataclass

Input for ListSubscriptions action.

Attributes

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

Token returned by the previous ListSubscriptions request.

Output

ListSubscriptionsOutput dataclass

Response for ListSubscriptions action

Attributes

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

Token to pass along to the next ListSubscriptions 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.