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 anISSUED
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"
)