:doc:`SNS <../../sns>` / Client / unsubscribe

***********
unsubscribe
***********



.. py:method:: 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.

   

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

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/Unsubscribe>`_  


  **Request Syntax**
  ::

    response = client.unsubscribe(
        SubscriptionArn='string'
    )
    
  :type SubscriptionArn: string
  :param SubscriptionArn: **[REQUIRED]** 

    The ARN of the subscription to be deleted.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`SNS.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`SNS.Client.exceptions.InternalErrorException`

  
  *   :py:class:`SNS.Client.exceptions.AuthorizationErrorException`

  
  *   :py:class:`SNS.Client.exceptions.NotFoundException`

  
  *   :py:class:`SNS.Client.exceptions.InvalidSecurityException`

  