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

Methods

(==) :: ListCertificates -> ListCertificates -> Bool

(/=) :: ListCertificates -> ListCertificates -> Bool

Data ListCertificates

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListCertificates -> c ListCertificates

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListCertificates

toConstr :: ListCertificates -> Constr

dataTypeOf :: ListCertificates -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListCertificates)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListCertificates)

gmapT :: (forall b. Data b => b -> b) -> ListCertificates -> ListCertificates

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListCertificates -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListCertificates -> r

gmapQ :: (forall d. Data d => d -> u) -> ListCertificates -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListCertificates -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListCertificates -> m ListCertificates

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListCertificates -> m ListCertificates

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListCertificates -> m ListCertificates

Read ListCertificates

Methods

readsPrec :: Int -> ReadS ListCertificates

readList :: ReadS [ListCertificates]

readPrec :: ReadPrec ListCertificates

readListPrec :: ReadPrec [ListCertificates]

Show ListCertificates

Methods

showsPrec :: Int -> ListCertificates -> ShowS

show :: ListCertificates -> String

showList :: [ListCertificates] -> ShowS

Generic ListCertificates

Associated Types

type Rep ListCertificates :: * -> *

Methods

from :: ListCertificates -> Rep ListCertificates x

to :: Rep ListCertificates x -> ListCertificates

ToJSON ListCertificates

Methods

toJSON :: ListCertificates -> Value

toEncoding :: ListCertificates -> Encoding

Hashable ListCertificates

Methods

hashWithSalt :: Int -> ListCertificates -> Int

hash :: ListCertificates -> Int

NFData ListCertificates

Methods

rnf :: ListCertificates -> ()

AWSRequest ListCertificates

Associated Types

type Rs ListCertificates :: *

Methods

request :: ListCertificates -> Request ListCertificates

response :: MonadResource m => Logger -> Service -> Proxy * ListCertificates -> ClientResponse -> m (Response ListCertificates)

ToPath ListCertificates

Methods

toPath :: ListCertificates -> ByteString

ToHeaders ListCertificates

Methods

toHeaders :: ListCertificates -> [Header]

ToQuery ListCertificates

Methods

toQuery :: ListCertificates -> QueryString

type Rep ListCertificates

type Rep ListCertificates = D1 (MetaData "ListCertificates" "Network.AWS.CertificateManager.ListCertificates" "amazonka-certificatemanager-1.4.2-6MBpEGpqoNwAnY7LGxPhTL" False) (C1 (MetaCons "ListCertificates'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_lcCertificateStatuses") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [CertificateStatus]))) ((:*:) (S1 (MetaSel (Just Symbol "_lcNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lcMaxItems") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))))))

type Rs 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

Methods

(==) :: ListCertificatesResponse -> ListCertificatesResponse -> Bool

(/=) :: ListCertificatesResponse -> ListCertificatesResponse -> Bool

Data ListCertificatesResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ListCertificatesResponse -> c ListCertificatesResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ListCertificatesResponse

toConstr :: ListCertificatesResponse -> Constr

dataTypeOf :: ListCertificatesResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ListCertificatesResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ListCertificatesResponse)

gmapT :: (forall b. Data b => b -> b) -> ListCertificatesResponse -> ListCertificatesResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ListCertificatesResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ListCertificatesResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> ListCertificatesResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ListCertificatesResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ListCertificatesResponse -> m ListCertificatesResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ListCertificatesResponse -> m ListCertificatesResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ListCertificatesResponse -> m ListCertificatesResponse

Read ListCertificatesResponse

Methods

readsPrec :: Int -> ReadS ListCertificatesResponse

readList :: ReadS [ListCertificatesResponse]

readPrec :: ReadPrec ListCertificatesResponse

readListPrec :: ReadPrec [ListCertificatesResponse]

Show ListCertificatesResponse

Methods

showsPrec :: Int -> ListCertificatesResponse -> ShowS

show :: ListCertificatesResponse -> String

showList :: [ListCertificatesResponse] -> ShowS

Generic ListCertificatesResponse

Associated Types

type Rep ListCertificatesResponse :: * -> *

Methods

from :: ListCertificatesResponse -> Rep ListCertificatesResponse x

to :: Rep ListCertificatesResponse x -> ListCertificatesResponse

NFData ListCertificatesResponse

Methods

rnf :: ListCertificatesResponse -> ()

type Rep ListCertificatesResponse

type Rep ListCertificatesResponse = D1 (MetaData "ListCertificatesResponse" "Network.AWS.CertificateManager.ListCertificates" "amazonka-certificatemanager-1.4.2-6MBpEGpqoNwAnY7LGxPhTL" False) (C1 (MetaCons "ListCertificatesResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_lcrsCertificateSummaryList") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [CertificateSummary]))) ((:*:) (S1 (MetaSel (Just Symbol "_lcrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_lcrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))

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.