| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ListSubscriptions
Description
The ListSubscriptions action 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.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- NextToken
Token returned by the previous
ListSubscriptionsrequest.Type: String
Required: No
Response Elements
The following
elements are
returned in a ListSubscriptionsResult structure.
- NextToken
Token to pass along to the next
ListSubscriptionsrequest. This element is returned if there are more subscriptions to retrieve.Type: String
- Subscriptions
A list of subscriptions.
Type: Subscription list
Errors
For information about the errors that are common to all actions, see Common Errors.
- AuthorizationError
Indicates that the user has been denied access to the requested resource.
HTTP Status Code: 403
- InternalError
Indicates an internal service error.
HTTP Status Code: 500
- InvalidParameter
Indicates that a request parameter does not comply with the associated constraints.
HTTP Status Code: 400
Examples
Sample Request
http://sns.us-east-1.amazonaws.com/ &Action=ListSubscriptions &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2010-03-31T12%3A00%3A00.000Z &AWSAccessKeyId=(AWS Access Key ID) &Signature=SZmBxEPqfs9R7xxhSt6C1b7PnOEvg%2BSVyyMYJfLRFCA%3D
Sample Response
<ListSubscriptionsResponse xmlns="http://sns.amazonaws.com/doc/2010-03-31/">
<ListSubscriptionsResult>
<Subscriptions>
<member>
<TopicArn>arn:aws:sns:us-east-1:698519295917:My-Topic</TopicArn>
<Protocol>email</Protocol>
<SubscriptionArn>arn:aws:sns:us-east-1:123456789012:My-Topic:80289ba6-0fd4-4079-afb4-ce8c8260f0ca</SubscriptionArn>
<Owner>123456789012</Owner>
<Endpoint>example@amazon.com</Endpoint>
</member>
</Subscriptions>
</ListSubscriptionsResult>
<ResponseMetadata>
<RequestId>384ac68d-3775-11df-8963-01868b7c937a</RequestId>
</ResponseMetadata>
</ListSubscriptionsResponse>
