SNS / Client / unsubscribe

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).

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