:doc:`CloudFront <../../cloudfront>` / Client / get_managed_certificate_details

*******************************
get_managed_certificate_details
*******************************



.. py:method:: CloudFront.Client.get_managed_certificate_details(**kwargs)

  

  Gets details about the CloudFront managed ACM certificate.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/GetManagedCertificateDetails>`_  


  **Request Syntax**
  ::

    response = client.get_managed_certificate_details(
        Identifier='string'
    )
    
  :type Identifier: string
  :param Identifier: **[REQUIRED]** 

    The identifier of the distribution tenant. You can specify the ARN, ID, or name of the distribution tenant.

    

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

    
    ::

      {
          'ManagedCertificateDetails': {
              'CertificateArn': 'string',
              'CertificateStatus': 'pending-validation'|'issued'|'inactive'|'expired'|'validation-timed-out'|'revoked'|'failed',
              'ValidationTokenHost': 'cloudfront'|'self-hosted',
              'ValidationTokenDetails': [
                  {
                      'Domain': 'string',
                      'RedirectTo': 'string',
                      'RedirectFrom': 'string'
                  },
              ]
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ManagedCertificateDetails** *(dict) --* 

        Contains details about the CloudFront managed ACM certificate.

        
        

        - **CertificateArn** *(string) --* 

          The ARN of the CloudFront managed ACM certificate.

          
        

        - **CertificateStatus** *(string) --* 

          The status of the CloudFront managed ACM certificate.

           

          .. note::

            

            Your distribution tenant will be updated with the latest certificate status. When calling the `UpdateDistributionTenant <https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistributionTenant.html>`__ operation, use the latest value for the ``ETag``.

            

          
        

        - **ValidationTokenHost** *(string) --* 

          Contains details about the validation token host of the specified CloudFront managed ACM certificate.

           

          
          * For ``cloudfront``, CloudFront will automatically serve the validation token. Choose this mode if you can point the domain's DNS to CloudFront immediately.
           
          * For ``self-hosted``, you serve the validation token from your existing infrastructure. Choose this mode when you need to maintain current traffic flow while your certificate is being issued. You can place the validation token at the well-known path on your existing web server, wait for ACM to validate and issue the certificate, and then update your DNS to point to CloudFront.
          

           

          .. note::

            

            This setting only affects the initial certificate request. Once the DNS points to CloudFront, all future certificate renewals are automatically handled through CloudFront.

            

          
        

        - **ValidationTokenDetails** *(list) --* 

          Contains details about the validation token of the specified CloudFront managed ACM certificate.

          
          

          - *(dict) --* 

            Contains details about the validation token.

            
            

            - **Domain** *(string) --* 

              The domain name.

              
            

            - **RedirectTo** *(string) --* 

              The domain to redirect to.

              
            

            - **RedirectFrom** *(string) --* 

              The domain to redirect from.

              
        
      
    
  
  **Exceptions**
  
  *   :py:class:`CloudFront.Client.exceptions.AccessDenied`

  
  *   :py:class:`CloudFront.Client.exceptions.EntityNotFound`

  