:doc:`ACM <../../acm>` / Client / renew_certificate

*****************
renew_certificate
*****************



.. py:method:: ACM.Client.renew_certificate(**kwargs)

  

  Renews an `eligible ACM certificate <https://docs.aws.amazon.com/acm/latest/userguide/managed-renewal.html>`__. In order to renew your Amazon Web Services Private CA certificates with ACM, you must first `grant the ACM service principal permission to do so <https://docs.aws.amazon.com/privateca/latest/userguide/PcaPermissions.html>`__. For more information, see `Testing Managed Renewal <https://docs.aws.amazon.com/acm/latest/userguide/manual-renewal.html>`__ in the ACM User Guide.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/acm-2015-12-08/RenewCertificate>`_  


  **Request Syntax**
  ::

    response = client.renew_certificate(
        CertificateArn='string'
    )
    
  :type CertificateArn: string
  :param CertificateArn: **[REQUIRED]** 

    String that contains the ARN of the ACM certificate to be renewed. This must be of the form:

     

    ``arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012``

     

    For more information about ARNs, see `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html>`__.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`ACM.Client.exceptions.InvalidArnException`

  
  *   :py:class:`ACM.Client.exceptions.RequestInProgressException`

  
  *   :py:class:`ACM.Client.exceptions.ResourceNotFoundException`

  