amazonka-certificatemanager-pca-2.0: Amazon Certificate Manager Private Certificate Authority SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.CertificateManagerPCA.ListTags

Description

Lists the tags, if any, that are associated with your private CA or one that has been shared with you. Tags are labels that you can use to identify and organize your CAs. Each tag consists of a key and an optional value. Call the TagCertificateAuthority action to add one or more tags to your CA. Call the UntagCertificateAuthority action to remove tags.

This operation returns paginated results.

Synopsis

Creating a Request

data ListTags Source #

See: newListTags smart constructor.

Constructors

ListTags' 

Fields

  • maxResults :: Maybe Natural

    Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

  • nextToken :: Maybe Text

    Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

  • certificateAuthorityArn :: Text

    The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority action. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

Instances

Instances details
ToJSON ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

ToHeaders ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Methods

toHeaders :: ListTags -> [Header] #

ToPath ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

ToQuery ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

AWSPager ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

AWSRequest ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Associated Types

type AWSResponse ListTags #

Generic ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Associated Types

type Rep ListTags :: Type -> Type #

Methods

from :: ListTags -> Rep ListTags x #

to :: Rep ListTags x -> ListTags #

Read ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Show ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

NFData ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Methods

rnf :: ListTags -> () #

Eq ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Hashable ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Methods

hashWithSalt :: Int -> ListTags -> Int #

hash :: ListTags -> Int #

type AWSResponse ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

type Rep ListTags Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

type Rep ListTags = D1 ('MetaData "ListTags" "Amazonka.CertificateManagerPCA.ListTags" "amazonka-certificatemanager-pca-2.0-BrCc8DEClV63rMSVXz2XYH" 'False) (C1 ('MetaCons "ListTags'" 'PrefixI 'True) (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "certificateAuthorityArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newListTags Source #

Arguments

:: Text

ListTags

-> ListTags 

Create a value of ListTags with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:maxResults:ListTags', listTags_maxResults - Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

ListTags, listTags_nextToken - Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

ListTags, listTags_certificateAuthorityArn - The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority action. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

Request Lenses

listTags_maxResults :: Lens' ListTags (Maybe Natural) Source #

Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

listTags_nextToken :: Lens' ListTags (Maybe Text) Source #

Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

listTags_certificateAuthorityArn :: Lens' ListTags Text Source #

The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority action. This must be of the form:

arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

Destructuring the Response

data ListTagsResponse Source #

See: newListTagsResponse smart constructor.

Constructors

ListTagsResponse' 

Fields

  • nextToken :: Maybe Text

    When the list is truncated, this value is present and should be used for the NextToken parameter in a subsequent pagination request.

  • tags :: Maybe (NonEmpty Tag)

    The tags associated with your private CA.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Associated Types

type Rep ListTagsResponse :: Type -> Type #

Read ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Show ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

NFData ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

Methods

rnf :: ListTagsResponse -> () #

Eq ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

type Rep ListTagsResponse Source # 
Instance details

Defined in Amazonka.CertificateManagerPCA.ListTags

type Rep ListTagsResponse = D1 ('MetaData "ListTagsResponse" "Amazonka.CertificateManagerPCA.ListTags" "amazonka-certificatemanager-pca-2.0-BrCc8DEClV63rMSVXz2XYH" 'False) (C1 ('MetaCons "ListTagsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty Tag))) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListTagsResponse Source #

Create a value of ListTagsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

ListTags, listTagsResponse_nextToken - When the list is truncated, this value is present and should be used for the NextToken parameter in a subsequent pagination request.

$sel:tags:ListTagsResponse', listTagsResponse_tags - The tags associated with your private CA.

$sel:httpStatus:ListTagsResponse', listTagsResponse_httpStatus - The response's http status code.

Response Lenses

listTagsResponse_nextToken :: Lens' ListTagsResponse (Maybe Text) Source #

When the list is truncated, this value is present and should be used for the NextToken parameter in a subsequent pagination request.

listTagsResponse_tags :: Lens' ListTagsResponse (Maybe (NonEmpty Tag)) Source #

The tags associated with your private CA.

listTagsResponse_httpStatus :: Lens' ListTagsResponse Int Source #

The response's http status code.