:doc:`DatabaseMigrationService <../../dms>` / Client / delete_certificate

******************
delete_certificate
******************



.. py:method:: DatabaseMigrationService.Client.delete_certificate(**kwargs)

  

  Deletes the specified certificate.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DeleteCertificate>`_  


  **Request Syntax**
  ::

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

    The Amazon Resource Name (ARN) of the certificate.

    

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

    
    ::

      {
          'Certificate': {
              'CertificateIdentifier': 'string',
              'CertificateCreationDate': datetime(2015, 1, 1),
              'CertificatePem': 'string',
              'CertificateWallet': b'bytes',
              'CertificateArn': 'string',
              'CertificateOwner': 'string',
              'ValidFromDate': datetime(2015, 1, 1),
              'ValidToDate': datetime(2015, 1, 1),
              'SigningAlgorithm': 'string',
              'KeyLength': 123,
              'KmsKeyId': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Certificate** *(dict) --* 

        The Secure Sockets Layer (SSL) certificate.

        
        

        - **CertificateIdentifier** *(string) --* 

          A customer-assigned name for the certificate. Identifiers must begin with a letter and must contain only ASCII letters, digits, and hyphens. They can't end with a hyphen or contain two consecutive hyphens.

          
        

        - **CertificateCreationDate** *(datetime) --* 

          The date that the certificate was created.

          
        

        - **CertificatePem** *(string) --* 

          The contents of a ``.pem`` file, which contains an X.509 certificate.

          
        

        - **CertificateWallet** *(bytes) --* 

          The location of an imported Oracle Wallet certificate for use with SSL. Example: ``filebase64("${path.root}/rds-ca-2019-root.sso")``

          
        

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

          The Amazon Resource Name (ARN) for the certificate.

          
        

        - **CertificateOwner** *(string) --* 

          The owner of the certificate.

          
        

        - **ValidFromDate** *(datetime) --* 

          The beginning date that the certificate is valid.

          
        

        - **ValidToDate** *(datetime) --* 

          The final date that the certificate is valid.

          
        

        - **SigningAlgorithm** *(string) --* 

          The signing algorithm for the certificate.

          
        

        - **KeyLength** *(integer) --* 

          The key length of the cryptographic algorithm being used.

          
        

        - **KmsKeyId** *(string) --* 

          An KMS key identifier that is used to encrypt the certificate.

           

          If you don't specify a value for the ``KmsKeyId`` parameter, then DMS uses your default encryption key.

           

          KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

          
    
  
  **Exceptions**
  
  *   :py:class:`DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault`

  
  *   :py:class:`DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault`

  

  **Examples**

  Deletes the specified certificate.
  ::

    response = client.delete_certificate(
        CertificateArn='arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUSM457DE6XFJCJQ',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'Certificate': {
        },
        'ResponseMetadata': {
            '...': '...',
        },
    }

  