:doc:`IoT <../../iot>` / Paginator / ListCertificates

****************
ListCertificates
****************



.. py:class:: IoT.Paginator.ListCertificates

  ::

    
    paginator = client.get_paginator('list_certificates')

  
  

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

    Creates an iterator that will paginate through responses from :py:meth:`IoT.Client.list_certificates`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-2015-05-28/ListCertificates>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          ascendingOrder=True|False,
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type ascendingOrder: boolean
    :param ascendingOrder: 

      Specifies the order for results. If True, the results are returned in ascending order, based on the creation date.

      

    
    :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**

      
      ::

        {
            'certificates': [
                {
                    'certificateArn': 'string',
                    'certificateId': 'string',
                    'status': 'ACTIVE'|'INACTIVE'|'REVOKED'|'PENDING_TRANSFER'|'REGISTER_INACTIVE'|'PENDING_ACTIVATION',
                    'certificateMode': 'DEFAULT'|'SNI_ONLY',
                    'creationDate': datetime(2015, 1, 1)
                },
            ],
            'NextToken': 'string'
        }
        
      **Response Structure**

      

      - *(dict) --* 

        The output of the ListCertificates operation.

        
        

        - **certificates** *(list) --* 

          The descriptions of the certificates.

          
          

          - *(dict) --* 

            Information about a certificate.

            
            

            - **certificateArn** *(string) --* 

              The ARN of the certificate.

              
            

            - **certificateId** *(string) --* 

              The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

              
            

            - **status** *(string) --* 

              The status of the certificate.

               

              The status value REGISTER_INACTIVE is deprecated and should not be used.

              
            

            - **certificateMode** *(string) --* 

              The mode of the certificate.

               

              ``DEFAULT``: A certificate in ``DEFAULT`` mode is either generated by Amazon Web Services IoT Core or registered with an issuer certificate authority (CA) in ``DEFAULT`` mode. Devices with certificates in ``DEFAULT`` mode aren't required to send the Server Name Indication (SNI) extension when connecting to Amazon Web Services IoT Core. However, to use features such as custom domains and VPC endpoints, we recommend that you use the SNI extension when connecting to Amazon Web Services IoT Core.

               

              ``SNI_ONLY``: A certificate in ``SNI_ONLY`` mode is registered without an issuer CA. Devices with certificates in ``SNI_ONLY`` mode must send the SNI extension when connecting to Amazon Web Services IoT Core.

              
            

            - **creationDate** *(datetime) --* 

              The date and time the certificate was created.

              
        
      
        

        - **NextToken** *(string) --* 

          A token to resume pagination.

          
    