DatabaseMigrationService / Client / import_certificate

import_certificate#

DatabaseMigrationService.Client.import_certificate(**kwargs)#

Uploads the specified certificate.

See also: AWS API Documentation

Request Syntax

response = client.import_certificate(
    CertificateIdentifier='string',
    CertificatePem='string',
    CertificateWallet=b'bytes',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string',
            'ResourceArn': 'string'
        },
    ]
)
Parameters:
  • CertificateIdentifier (string) –

    [REQUIRED]

    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.

  • 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. Provide the name of a .sso file using the fileb:// prefix. You can’t provide the certificate inline.

    Example: filebase64("${path.root}/rds-ca-2019-root.sso")

  • Tags (list) –

    The tags associated with the certificate.

    • (dict) –

      A user-defined key-value pair that describes metadata added to an DMS resource and that is used by operations such as the following:

      • AddTagsToResource

      • ListTagsForResource

      • RemoveTagsFromResource

      • Key (string) –

        A key is the required name of the tag. The string value can be 1-128 Unicode characters in length and can’t be prefixed with “aws:” or “dms:”. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘/’, ‘=’, ‘+’, ‘-’ (Java regular expressions: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

      • Value (string) –

        A value is the optional value of the tag. The string value can be 1-256 Unicode characters in length and can’t be prefixed with “aws:” or “dms:”. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘/’, ‘=’, ‘+’, ‘-’ (Java regular expressions: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

      • ResourceArn (string) –

        The Amazon Resource Name (ARN) string that uniquely identifies the resource for which the tag is created.

Return type:

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
    }
}

Response Structure

  • (dict) –

    • Certificate (dict) –

      The certificate to be uploaded.

      • 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.

Exceptions

  • DatabaseMigrationService.Client.exceptions.ResourceAlreadyExistsFault

  • DatabaseMigrationService.Client.exceptions.InvalidCertificateFault

  • DatabaseMigrationService.Client.exceptions.ResourceQuotaExceededFault

Examples

Uploads the specified certificate.

response = client.import_certificate(
    CertificateIdentifier='',
    CertificatePem='',
)

print(response)

Expected Output:

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