:doc:`Schemas <../../schemas>` / Client / list_registries

***************
list_registries
***************



.. py:method:: Schemas.Client.list_registries(**kwargs)

  

  List the registries.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/schemas-2019-12-02/ListRegistries>`_  


  **Request Syntax**
  ::

    response = client.list_registries(
        Limit=123,
        NextToken='string',
        RegistryNamePrefix='string',
        Scope='string'
    )
    
  :type Limit: integer
  :param Limit: 

  
  :type NextToken: string
  :param NextToken: 

    The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.

    

  
  :type RegistryNamePrefix: string
  :param RegistryNamePrefix: 

    Specifying this limits the results to only those registry names that start with the specified prefix.

    

  
  :type Scope: string
  :param Scope: 

    Can be set to Local or AWS to limit responses to your custom registries, or the ones provided by AWS.

    

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

    
    ::

      {
          'NextToken': 'string',
          'Registries': [
              {
                  'RegistryArn': 'string',
                  'RegistryName': 'string',
                  'Tags': {
                      'string': 'string'
                  }
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 

      200 response

      
      

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

        The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.

        
      

      - **Registries** *(list) --* 

        An array of registry summaries.

        
        

        - *(dict) --* 
          

          - **RegistryArn** *(string) --* 

            The ARN of the registry.

            
          

          - **RegistryName** *(string) --* 

            The name of the registry.

            
          

          - **Tags** *(dict) --* 

            Tags associated with the registry.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
      
    
  
  **Exceptions**
  
  *   :py:class:`Schemas.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`Schemas.Client.exceptions.BadRequestException`

  
  *   :py:class:`Schemas.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`Schemas.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`Schemas.Client.exceptions.ForbiddenException`

  