Skip to content

Get Certificates

lightsail_get_certificates R Documentation

Returns information about one or more Amazon Lightsail SSL/TLS certificates

Description

Returns information about one or more Amazon Lightsail SSL/TLS certificates.

To get a summary of a certificate, omit includeCertificateDetails from your request. The response will include only the certificate Amazon Resource Name (ARN), certificate name, domain name, and tags.

Usage

lightsail_get_certificates(certificateStatuses,
  includeCertificateDetails, certificateName, pageToken)

Arguments

certificateStatuses

The status of the certificates for which to return information.

For example, specify ISSUED to return only certificates with an ISSUED status.

When omitted, the response includes all of your certificates in the Amazon Web Services Region where the request is made, regardless of their current status.

includeCertificateDetails

Indicates whether to include detailed information about the certificates in the response.

When omitted, the response includes only the certificate names, Amazon Resource Names (ARNs), domain names, and tags.

certificateName

The name for the certificate for which to return information.

When omitted, the response includes all of your certificates in the Amazon Web Services Region where the request is made.

pageToken

The token to advance to the next page of results from your request.

To get a page token, perform an initial get_certificates request. If your results are paginated, the response will return a next page token that you can specify as the page token in a subsequent request.

Value

A list with the following syntax:

list(
  certificates = list(
    list(
      certificateArn = "string",
      certificateName = "string",
      domainName = "string",
      certificateDetail = list(
        arn = "string",
        name = "string",
        domainName = "string",
        status = "PENDING_VALIDATION"|"ISSUED"|"INACTIVE"|"EXPIRED"|"VALIDATION_TIMED_OUT"|"REVOKED"|"FAILED",
        serialNumber = "string",
        subjectAlternativeNames = list(
          "string"
        ),
        domainValidationRecords = list(
          list(
            domainName = "string",
            resourceRecord = list(
              name = "string",
              type = "string",
              value = "string"
            ),
            dnsRecordCreationState = list(
              code = "SUCCEEDED"|"STARTED"|"FAILED",
              message = "string"
            ),
            validationStatus = "PENDING_VALIDATION"|"FAILED"|"SUCCESS"
          )
        ),
        requestFailureReason = "string",
        inUseResourceCount = 123,
        keyAlgorithm = "string",
        createdAt = as.POSIXct(
          "2015-01-01"
        ),
        issuedAt = as.POSIXct(
          "2015-01-01"
        ),
        issuerCA = "string",
        notBefore = as.POSIXct(
          "2015-01-01"
        ),
        notAfter = as.POSIXct(
          "2015-01-01"
        ),
        eligibleToRenew = "string",
        renewalSummary = list(
          domainValidationRecords = list(
            list(
              domainName = "string",
              resourceRecord = list(
                name = "string",
                type = "string",
                value = "string"
              ),
              dnsRecordCreationState = list(
                code = "SUCCEEDED"|"STARTED"|"FAILED",
                message = "string"
              ),
              validationStatus = "PENDING_VALIDATION"|"FAILED"|"SUCCESS"
            )
          ),
          renewalStatus = "PendingAutoRenewal"|"PendingValidation"|"Success"|"Failed",
          renewalStatusReason = "string",
          updatedAt = as.POSIXct(
            "2015-01-01"
          )
        ),
        revokedAt = as.POSIXct(
          "2015-01-01"
        ),
        revocationReason = "string",
        tags = list(
          list(
            key = "string",
            value = "string"
          )
        ),
        supportCode = "string"
      ),
      tags = list(
        list(
          key = "string",
          value = "string"
        )
      )
    )
  ),
  nextPageToken = "string"
)

Request syntax

svc$get_certificates(
  certificateStatuses = list(
    "PENDING_VALIDATION"|"ISSUED"|"INACTIVE"|"EXPIRED"|"VALIDATION_TIMED_OUT"|"REVOKED"|"FAILED"
  ),
  includeCertificateDetails = TRUE|FALSE,
  certificateName = "string",
  pageToken = "string"
)