:doc:`Pricing <../../pricing>` / Paginator / DescribeServices

****************
DescribeServices
****************



.. py:class:: Pricing.Paginator.DescribeServices

  ::

    
    paginator = client.get_paginator('describe_services')

  
  

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

    Creates an iterator that will paginate through responses from :py:meth:`Pricing.Client.describe_services`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/pricing-2017-10-15/DescribeServices>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          ServiceCode='string',
          FormatVersion='string',
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type ServiceCode: string
    :param ServiceCode: 

      The code for the service whose information you want to retrieve, such as ``AmazonEC2``. You can use the ``ServiceCode`` to filter the results in a ``GetProducts`` call. To retrieve a list of all services, leave this blank.

      

    
    :type FormatVersion: string
    :param FormatVersion: 

      The format version that you want the response to be in.

       

      Valid values are: ``aws_v1``

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

      
    
    
    :rtype: dict
    :returns: 
      
      **Response Syntax**

      
      ::

        {
            'Services': [
                {
                    'ServiceCode': 'string',
                    'AttributeNames': [
                        'string',
                    ]
                },
            ],
            'FormatVersion': 'string',
            
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **Services** *(list) --* 

          The service metadata for the service or services in the response.

          
          

          - *(dict) --* 

            The metadata for a service, such as the service code and available attribute names.

            
            

            - **ServiceCode** *(string) --* 

              The code for the Amazon Web Services service.

              
            

            - **AttributeNames** *(list) --* 

              The attributes that are available for this service.

              
              

              - *(string) --* 
          
        
      
        

        - **FormatVersion** *(string) --* 

          The format version of the response. For example, ``aws_v1``.

          
    