Skip to content

Certificate

Source code in docs_src/capo_lightsail/types/certificate.py
class Certificate(TypedDict, closed=True):
    arn: NotRequired["capo_lightsail.types.non_empty_string.NonEmptyString"]
    """<p>The Amazon Resource Name (ARN) of the certificate.</p>"""
    name: NotRequired["capo_lightsail.types.certificate_name.CertificateName"]
    """<p>The name of the certificate (<code>my-certificate</code>).</p>"""
    domain_name: NotRequired["capo_lightsail.types.domain_name.DomainName"]
    """<p>The domain name of the certificate.</p>"""
    status: NotRequired["capo_lightsail.types.certificate_status.CertificateStatus"]
    """<p>The validation status of the certificate.</p>"""
    serial_number: NotRequired["capo_lightsail.types.serial_number.SerialNumber"]
    """<p>The serial number of the certificate.</p>"""
    subject_alternative_names: NotRequired[
        "capo_lightsail.types.subject_alternative_name_list.SubjectAlternativeNameList"
    ]
    """<p>An array of strings that specify the alternate domains (<code>example2.com</code>) and subdomains (<code>blog.example.com</code>) of the certificate.</p>"""
    domain_validation_records: NotRequired[
        "capo_lightsail.types.domain_validation_record_list.DomainValidationRecordList"
    ]
    """<p>An array of objects that describe the domain validation records of the certificate.</p>"""
    request_failure_reason: NotRequired[
        "capo_lightsail.types.request_failure_reason.RequestFailureReason"
    ]
    """<p>The validation failure reason, if any, of the certificate.</p> <p>The following failure reasons are possible:</p> <ul> <li> <p> <b> <code>NO_AVAILABLE_CONTACTS</code> </b> - This failure applies to email validation, which is not available for Lightsail certificates.</p> </li> <li> <p> <b> <code>ADDITIONAL_VERIFICATION_REQUIRED</code> </b> - Lightsail requires additional information to process this certificate request. This can happen as a fraud-protection measure, such as when the domain ranks within the Alexa top 1000 websites. To provide the required information, use the <a href="https://console.aws.amazon.com/support/home">Amazon Web Services Support Center</a> to contact Amazon Web Services Support.</p> <note> <p>You cannot request a certificate for Amazon-owned domain names such as those ending in amazonaws.com, cloudfront.net, or elasticbeanstalk.com.</p> </note> </li> <li> <p> <b> <code>DOMAIN_NOT_ALLOWED</code> </b> - One or more of the domain names in the certificate request was reported as an unsafe domain by <a href="https://www.virustotal.com/gui/home/url">VirusTotal</a>. To correct the problem, search for your domain name on the <a href="https://www.virustotal.com/gui/home/url">VirusTotal</a> website. If your domain is reported as suspicious, see <a href="https://developers.google.com/web/fundamentals/security/hacked">Google Help for Hacked Websites</a> to learn what you can do.</p> <p>If you believe that the result is a false positive, notify the organization that is reporting the domain. VirusTotal is an aggregate of several antivirus and URL scanners and cannot remove your domain from a block list itself. After you correct the problem and the VirusTotal registry has been updated, request a new certificate.</p> <p>If you see this error and your domain is not included in the VirusTotal list, visit the <a href="https://console.aws.amazon.com/support/home">Amazon Web Services Support Center</a> and create a case.</p> </li> <li> <p> <b> <code>INVALID_PUBLIC_DOMAIN</code> </b> - One or more of the domain names in the certificate request is not valid. Typically, this is because a domain name in the request is not a valid top-level domain. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request, and ensure that all domain names in the request are for valid top-level domains. For example, you cannot request a certificate for <code>example.invalidpublicdomain</code> because <code>invalidpublicdomain</code> is not a valid top-level domain.</p> </li> <li> <p> <b> <code>OTHER</code> </b> - Typically, this failure occurs when there is a typographical error in one or more of the domain names in the certificate request. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request. </p> </li> </ul>"""
    in_use_resource_count: (
        "capo_lightsail.types.in_use_resource_count.InUseResourceCount"
    )
    """<p>The number of Lightsail resources that the certificate is attached to.</p>"""
    key_algorithm: NotRequired["capo_lightsail.types.key_algorithm.KeyAlgorithm"]
    """<p>The algorithm used to generate the key pair (the public and private key) of the certificate.</p>"""
    created_at: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the certificate was created.</p>"""
    issued_at: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the certificate was issued.</p>"""
    issuer_ca: NotRequired["capo_lightsail.types.issuer_ca.IssuerCA"]
    """<p>The certificate authority that issued the certificate.</p>"""
    not_before: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the certificate is first valid.</p>"""
    not_after: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the certificate expires.</p>"""
    eligible_to_renew: NotRequired[
        "capo_lightsail.types.eligible_to_renew.EligibleToRenew"
    ]
    """<p>The renewal eligibility of the certificate.</p>"""
    renewal_summary: NotRequired["capo_lightsail.types.renewal_summary.RenewalSummary"]
    """<p>An object that describes the status of the certificate renewal managed by Lightsail.</p>"""
    revoked_at: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the certificate was revoked. This value is present only when the certificate status is <code>REVOKED</code>.</p>"""
    revocation_reason: NotRequired[
        "capo_lightsail.types.revocation_reason.RevocationReason"
    ]
    """<p>The reason the certificate was revoked. This value is present only when the certificate status is <code>REVOKED</code>.</p>"""
    tags: NotRequired["capo_lightsail.types.tag_list.TagList"]
    """<p>The tag keys and optional values for the resource. For more information about tags in Lightsail, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags">Amazon Lightsail Developer Guide</a>.</p>"""
    support_code: NotRequired["capo_lightsail.types.string.string"]
    """<p>The support code. Include this code in your email to support when you have questions about your Lightsail certificate. This code enables our support team to look up your Lightsail information more easily.</p>"""

arn instance-attribute

arn: NotRequired[NonEmptyString]

The Amazon Resource Name (ARN) of the certificate.

created_at instance-attribute

created_at: NotRequired[IsoDate]

The timestamp when the certificate was created.

domain_name instance-attribute

domain_name: NotRequired[DomainName]

The domain name of the certificate.

domain_validation_records instance-attribute

domain_validation_records: NotRequired[DomainValidationRecordList]

An array of objects that describe the domain validation records of the certificate.

eligible_to_renew instance-attribute

eligible_to_renew: NotRequired[EligibleToRenew]

The renewal eligibility of the certificate.

in_use_resource_count instance-attribute

in_use_resource_count: InUseResourceCount

The number of Lightsail resources that the certificate is attached to.

issued_at instance-attribute

issued_at: NotRequired[IsoDate]

The timestamp when the certificate was issued.

issuer_ca instance-attribute

issuer_ca: NotRequired[IssuerCA]

The certificate authority that issued the certificate.

key_algorithm instance-attribute

key_algorithm: NotRequired[KeyAlgorithm]

The algorithm used to generate the key pair (the public and private key) of the certificate.

name instance-attribute

name: NotRequired[CertificateName]

The name of the certificate (my-certificate).

not_after instance-attribute

not_after: NotRequired[IsoDate]

The timestamp when the certificate expires.

not_before instance-attribute

not_before: NotRequired[IsoDate]

The timestamp when the certificate is first valid.

renewal_summary instance-attribute

renewal_summary: NotRequired[RenewalSummary]

An object that describes the status of the certificate renewal managed by Lightsail.

request_failure_reason instance-attribute

request_failure_reason: NotRequired[RequestFailureReason]

The validation failure reason, if any, of the certificate.

The following failure reasons are possible:

  • NO_AVAILABLE_CONTACTS - This failure applies to email validation, which is not available for Lightsail certificates.

  • ADDITIONAL_VERIFICATION_REQUIRED - Lightsail requires additional information to process this certificate request. This can happen as a fraud-protection measure, such as when the domain ranks within the Alexa top 1000 websites. To provide the required information, use the Amazon Web Services Support Center to contact Amazon Web Services Support.

    You cannot request a certificate for Amazon-owned domain names such as those ending in amazonaws.com, cloudfront.net, or elasticbeanstalk.com.

  • DOMAIN_NOT_ALLOWED - One or more of the domain names in the certificate request was reported as an unsafe domain by VirusTotal. To correct the problem, search for your domain name on the VirusTotal website. If your domain is reported as suspicious, see Google Help for Hacked Websites to learn what you can do.

    If you believe that the result is a false positive, notify the organization that is reporting the domain. VirusTotal is an aggregate of several antivirus and URL scanners and cannot remove your domain from a block list itself. After you correct the problem and the VirusTotal registry has been updated, request a new certificate.

    If you see this error and your domain is not included in the VirusTotal list, visit the Amazon Web Services Support Center and create a case.

  • INVALID_PUBLIC_DOMAIN - One or more of the domain names in the certificate request is not valid. Typically, this is because a domain name in the request is not a valid top-level domain. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request, and ensure that all domain names in the request are for valid top-level domains. For example, you cannot request a certificate for example.invalidpublicdomain because invalidpublicdomain is not a valid top-level domain.

  • OTHER - Typically, this failure occurs when there is a typographical error in one or more of the domain names in the certificate request. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request.

revocation_reason instance-attribute

revocation_reason: NotRequired[RevocationReason]

The reason the certificate was revoked. This value is present only when the certificate status is REVOKED.

revoked_at instance-attribute

revoked_at: NotRequired[IsoDate]

The timestamp when the certificate was revoked. This value is present only when the certificate status is REVOKED.

serial_number instance-attribute

serial_number: NotRequired[SerialNumber]

The serial number of the certificate.

status instance-attribute

status: NotRequired[CertificateStatus]

The validation status of the certificate.

subject_alternative_names instance-attribute

subject_alternative_names: NotRequired[SubjectAlternativeNameList]

An array of strings that specify the alternate domains (example2.com) and subdomains (blog.example.com) of the certificate.

support_code instance-attribute

support_code: NotRequired[string]

The support code. Include this code in your email to support when you have questions about your Lightsail certificate. This code enables our support team to look up your Lightsail information more easily.

tags instance-attribute

tags: NotRequired[TagList]

The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.