unsubscribe

SNS.Client.unsubscribe(**kwargs)

Deletes a subscription. If the subscription requires authentication for deletion, only the owner of the subscription or the topic's owner can unsubscribe, and an Amazon Web Services signature is required. If the Unsubscribe call does not require authentication and the requester is not the subscription owner, a final cancellation message is delivered to the endpoint, so that the endpoint owner can easily resubscribe to the topic if the Unsubscribe request was unintended.

Note

Amazon SQS queue subscriptions require authentication for deletion. Only the owner of the subscription, or the owner of the topic can unsubscribe using the required Amazon Web Services signature.

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

See also: AWS API Documentation

Request Syntax

response = client.unsubscribe(
    SubscriptionArn='string'
)
Parameters
SubscriptionArn (string) --

[REQUIRED]

The ARN of the subscription to be deleted.

Returns
None

Exceptions

  • SNS.Client.exceptions.InvalidParameterException
  • SNS.Client.exceptions.InternalErrorException
  • SNS.Client.exceptions.AuthorizationErrorException
  • SNS.Client.exceptions.NotFoundException
  • SNS.Client.exceptions.InvalidSecurityException