Skip to main content

types

Certificate​

A certificate. For details about the concept, see documentation.

Status​

  • STATUS_UNSPECIFIED

  • VALIDATING

    The certificate domains validation are required. Used only for managed certificates.

  • INVALID

    The certificate issuance is failed. Used only for managed certificates.

  • ISSUED

    The certificate is issued.

  • REVOKED

    The certificate is revoked.

  • RENEWING

    The certificate renewal is started. Used only for managed certificates.

  • RENEWAL_FAILED

    The certificate renewal is failed. Used only for managed certificates.

id : string​

ID of the certificate. Generated at creation time.

folderId : string​

ID of the folder that the certificate belongs to.

createdAt : google.protobuf.Timestamp​

Creation timestamp.

name : string​

Name of the certificate. The name is unique within the folder.

description : string​

Description of the certificate.

labels : string​

Certificate labels as key:value pairs.

type : CertificateType​

Type of the certificate.

domains : string​

Fully qualified domain names of the certificate.

status : Status​

Status of the certificate.

issuer : string​

Distinguished Name of the certificate authority that issued the certificate.

subject : string​

Distinguished Name of the entity that is associated with the public key contained in the certificate.

serial : string​

Serial number of the certificate.

updatedAt : google.protobuf.Timestamp​

Time when the certificate is updated.

issuedAt : google.protobuf.Timestamp​

Time when the certificate is issued.

notAfter : google.protobuf.Timestamp​

Time after which the certificate is not valid.

notBefore : google.protobuf.Timestamp​

Time before which the certificate is not valid.

challenges : Challenge​

Domains validation challenges of the certificate. Used only for managed certificates.

deletionProtection : bool​

Flag that protects deletion of the certificate

incompleteChain : bool​

Mark imported certificates without uploaded chain or with chain which not lead to root certificate

Challenge​

Domain validation challenge.

Status​

  • STATUS_UNSPECIFIED

  • PENDING

    The challenge is waiting to be completed.

  • PROCESSING

    The challenge is awaiting approval from Let's Encrypt.

  • VALID

    The challenge is complete.

  • INVALID

    The rights check for a specific domain failed or the one-week period allocated for the check expired.

DnsRecord​

name : string​

Name of the DNS record.

type : string​

Type of the DNS-record.

value : string​

Value of the DNS-record.

HttpFile​

url : string​

Location of the HTTP file.

content : string​

Content of the HTTP file.

domain : string​

Domain of the challenge.

type : ChallengeType​

Type of the challenge.

createdAt : google.protobuf.Timestamp​

Time when the challenge is created.

updatedAt : google.protobuf.Timestamp​

Time when the challenge is updated.

status : Status​

Status of the challenge.

message : string​

Description of the challenge.

error : string​

Error of the challenge.

One of challenge​

Data of the challenge.

  • dnsChallenge : DnsRecord​

    DNS-record.

  • httpChallenge : HttpFile​

    HTTP-file.

Version​

A certificate version

id : string​

ID of the version.

certificateId : string​

ID of the certificate that the version belongs to.

createdAt : google.protobuf.Timestamp​

Time when the version was created.