Network.AWS.CertificateManager.ListCertificates

Retrieves a list of the ACM Certificate ARNs, and the domain name for each ARN, owned by the calling account. You can filter the list based on the CertificateStatuses parameter, and you can display up to MaxItems certificates at one time. If you have more than MaxItems certificates, use the NextToken marker from the response object in your next call to the ListCertificates action to retrieve the next set of certificate ARNs.

Creating a Request

listCertificates :: ListCertificates

Creates a value of ListCertificates with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lcCertificateStatuses
• lcNextToken
• lcMaxItems

data ListCertificates

See: listCertificates smart constructor.

Instances

Eq ListCertificates

Data ListCertificates

Read ListCertificates

Show ListCertificates

Generic ListCertificates

ToJSON ListCertificates

Hashable ListCertificates

AWSRequest ListCertificates

ToPath ListCertificates

ToHeaders ListCertificates

ToQuery ListCertificates

type Rep ListCertificates

type Rs ListCertificates = ListCertificatesResponse

Request Lenses

lcCertificateStatuses :: Lens' ListCertificates [CertificateStatus]

Identifies the statuses of the ACM Certificates for which you want to retrieve the ARNs. This can be one or more of the following values:

• PENDING_VALIDATION
• ISSUED
• INACTIVE
• EXPIRED
• VALIDATION_TIMED_OUT
• REVOKED
• FAILED

lcNextToken :: Lens' ListCertificates (Maybe Text)

String that contains an opaque marker of the next ACM Certificate ARN to be displayed. Use this parameter when paginating results, and only in a subsequent request after you've received a response where the results have been truncated. Set it to an empty string the first time you call this action, and set it to the value of the NextToken element you receive in the response object for subsequent calls.

lcMaxItems :: Lens' ListCertificates (Maybe Natural)

Specify this parameter when paginating results to indicate the maximum number of ACM Certificates that you want to display for each response. If there are additional certificates beyond the maximum you specify, use the NextToken value in your next call to the ListCertificates action.

Destructuring the Response

listCertificatesResponse

Arguments

:: Int

lcrsResponseStatus

-> ListCertificatesResponse

Creates a value of ListCertificatesResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lcrsCertificateSummaryList
• lcrsNextToken
• lcrsResponseStatus

data ListCertificatesResponse

See: listCertificatesResponse smart constructor.

Instances

Eq ListCertificatesResponse

Data ListCertificatesResponse

Read ListCertificatesResponse

Show ListCertificatesResponse

Generic ListCertificatesResponse

type Rep ListCertificatesResponse

Response Lenses

lcrsCertificateSummaryList :: Lens' ListCertificatesResponse [CertificateSummary]

A list of the certificate ARNs.

lcrsNextToken :: Lens' ListCertificatesResponse (Maybe Text)

If the list has been truncated, this value is present and should be used for the NextToken input parameter on your next call to ListCertificates.

lcrsResponseStatus :: Lens' ListCertificatesResponse Int

The response status code.