:doc:`Shield <../../shield>` / Client / get_subscription_state

**********************
get_subscription_state
**********************



.. py:method:: Shield.Client.get_subscription_state()

  

  Returns the ``SubscriptionState``, either ``Active`` or ``Inactive``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/GetSubscriptionState>`_  


  **Request Syntax**
  ::

    response = client.get_subscription_state()
    
    
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'SubscriptionState': 'ACTIVE'|'INACTIVE'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **SubscriptionState** *(string) --* 

        The status of the subscription.

        
  
  **Exceptions**
  
  *   :py:class:`Shield.Client.exceptions.InternalErrorException`

  