Skip to content

list_subscriptions_by_topic

Operation

list_subscriptions_by_topic

list_subscriptions_by_topic(request: ListSubscriptionsByTopicInput | ListSubscriptionsByTopicInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListSubscriptionsByTopicInputDict]) -> 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
request ListSubscriptionsByTopicInput | ListSubscriptionsByTopicInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[ListSubscriptionsByTopicInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListSubscriptionsByTopicOutput

An instance of ListSubscriptionsByTopicOutput.

list_subscriptions_by_topic async

list_subscriptions_by_topic(request: ListSubscriptionsByTopicInput | ListSubscriptionsByTopicInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListSubscriptionsByTopicInputDict]) -> 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
request ListSubscriptionsByTopicInput | ListSubscriptionsByTopicInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[ListSubscriptionsByTopicInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListSubscriptionsByTopicOutput

An instance of ListSubscriptionsByTopicOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

ListSubscriptionsByTopicInputDict

Bases: TypedDict

Dictionary form of ListSubscriptionsByTopicInput.

Attributes

next_token instance-attribute
next_token: str | None

Token returned by the previous ListSubscriptionsByTopic request.

topic_arn instance-attribute
topic_arn: Required[str]

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

ListSubscriptionsByTopicInput dataclass

Bases: _SerdeShape

Input for ListSubscriptionsByTopic action.

Attributes

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

Token returned by the previous ListSubscriptionsByTopic request.

topic_arn class-attribute instance-attribute
topic_arn: str | None = ...

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

Output

ListSubscriptionsByTopicOutput dataclass

Bases: _SerdeShape

Response for ListSubscriptionsByTopic action.

Attributes

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

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

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

subscriptions class-attribute instance-attribute
subscriptions: list[Subscription] | None = ...

A list of subscriptions.