:doc:`CloudFormation <../../cloudformation>` / Client / describe_publisher

******************
describe_publisher
******************



.. py:method:: CloudFormation.Client.describe_publisher(**kwargs)

  

  Returns information about a CloudFormation extension publisher.

   

  If you don't supply a ``PublisherId``, and you have registered as an extension publisher, ``DescribePublisher`` returns information about your own publisher account.

   

  For more information about registering as a publisher, see:

   

  
  * `RegisterPublisher <https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterPublisher.html>`__
   
  * `Publishing extensions to make them available for public use <https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/publish-extension.html>`__ in the *CloudFormation Command Line Interface (CLI) User Guide*
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribePublisher>`_  


  **Request Syntax**
  ::

    response = client.describe_publisher(
        PublisherId='string'
    )
    
  :type PublisherId: string
  :param PublisherId: 

    The ID of the extension publisher.

     

    If you don't supply a ``PublisherId``, and you have registered as an extension publisher, ``DescribePublisher`` returns information about your own publisher account.

    

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

    
    ::

      {
          'PublisherId': 'string',
          'PublisherStatus': 'VERIFIED'|'UNVERIFIED',
          'IdentityProvider': 'AWS_Marketplace'|'GitHub'|'Bitbucket',
          'PublisherProfile': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **PublisherId** *(string) --* 

        The ID of the extension publisher.

        
      

      - **PublisherStatus** *(string) --* 

        Whether the publisher is verified. Currently, all registered publishers are verified.

        
      

      - **IdentityProvider** *(string) --* 

        The type of account used as the identity provider when registering this publisher with CloudFormation.

        
      

      - **PublisherProfile** *(string) --* 

        The URL to the publisher's profile with the identity provider.

        
  
  **Exceptions**
  
  *   :py:class:`CloudFormation.Client.exceptions.CFNRegistryException`

  