:doc:`ServiceResource <index>` / Collection / subscriptions

*************
subscriptions
*************



.. py:attribute:: SNS.ServiceResource.subscriptions

  A collection of Subscription resources.A Subscription Collection will include all resources by default, and extreme caution should be taken when performing actions on all resources.

  .. py:method:: all()

    Creates an iterable of all Subscription resources in the collection.

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


    **Request Syntax**
    ::

      subscription_iterator = sns.subscriptions.all()
      
      
    
    :rtype: list(:py:class:`sns.Subscription`)
    :returns: A list of Subscription resources
    

  .. py:method:: filter(**kwargs)

    Creates an iterable of all Subscription resources in the collection filtered by kwargs passed to method. A Subscription collection will include all resources by default if no filters are provided, and extreme caution should be taken when performing actions on all resources.

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


    **Request Syntax**
    ::

      subscription_iterator = sns.subscriptions.filter(
          NextToken='string'
      )
      
    :type NextToken: string
    :param NextToken: 

      Token returned by the previous ``ListSubscriptions`` request.

      

    
    
    :rtype: list(:py:class:`sns.Subscription`)
    :returns: A list of Subscription resources
    

  .. py:method:: limit(**kwargs)

    Creates an iterable up to a specified amount of Subscription resources in the collection.

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


    **Request Syntax**
    ::

      subscription_iterator = sns.subscriptions.limit(
          count=123
      )
      
    :type count: integer
    :param count: The limit to the number of resources in the iterable.

    
    
    :rtype: list(:py:class:`sns.Subscription`)
    :returns: A list of Subscription resources
    

  .. py:method:: page_size(**kwargs)

    Creates an iterable of all Subscription resources in the collection, but limits the number of items returned by each service call by the specified amount.

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


    **Request Syntax**
    ::

      subscription_iterator = sns.subscriptions.page_size(
          count=123
      )
      
    :type count: integer
    :param count: The number of items returned by each service call

    
    
    :rtype: list(:py:class:`sns.Subscription`)
    :returns: A list of Subscription resources
    