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

***************
describe_schema
***************



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

  

  Retrieve the schema definition.

  

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


  **Request Syntax**
  ::

    response = client.describe_schema(
        RegistryName='string',
        SchemaName='string',
        SchemaVersion='string'
    )
    
  :type RegistryName: string
  :param RegistryName: **[REQUIRED]** 

    The name of the registry.

    

  
  :type SchemaName: string
  :param SchemaName: **[REQUIRED]** 

    The name of the schema.

    

  
  :type SchemaVersion: string
  :param SchemaVersion: 

    Specifying this limits the results to only this schema version.

    

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

    
    ::

      {
          'Content': 'string',
          'Description': 'string',
          'LastModified': datetime(2015, 1, 1),
          'SchemaArn': 'string',
          'SchemaName': 'string',
          'SchemaVersion': 'string',
          'Tags': {
              'string': 'string'
          },
          'Type': 'string',
          'VersionCreatedDate': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 

      200 response

      
      

      - **Content** *(string) --* 

        The source of the schema definition.

        
      

      - **Description** *(string) --* 

        The description of the schema.

        
      

      - **LastModified** *(datetime) --* 

        The date and time that schema was modified.

        
      

      - **SchemaArn** *(string) --* 

        The ARN of the schema.

        
      

      - **SchemaName** *(string) --* 

        The name of the schema.

        
      

      - **SchemaVersion** *(string) --* 

        The version number of the schema

        
      

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

        Tags associated with the resource.

        
        

        - *(string) --* 
          

          - *(string) --* 
    
  
      

      - **Type** *(string) --* 

        The type of the schema.

        
      

      - **VersionCreatedDate** *(datetime) --* 

        The date the schema version was created.

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

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

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

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

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

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

  