amazonka-backup-2.0: Amazon Backup 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.Backup.ListTags

Description

Returns a list of key-value pairs assigned to a target recovery point, backup plan, or backup vault.

ListTags only works for resource types that support full Backup management of their backups. Those resource types are listed in the "Full Backup management" section of the Feature availability by resource table.

Synopsis

Creating a Request

data ListTags Source #

See: newListTags smart constructor.

Constructors

ListTags' 

Fields

  • maxResults :: Maybe Natural

    The maximum number of items to be returned.

  • nextToken :: Maybe Text

    The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

  • resourceArn :: Text

    An Amazon Resource Name (ARN) that uniquely identifies a resource. The format of the ARN depends on the type of resource. Valid targets for ListTags are recovery points, backup plans, and backup vaults.

Instances

Instances details
ToHeaders ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Methods

toHeaders :: ListTags -> [Header] #

ToPath ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

ToQuery ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

AWSRequest ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Associated Types

type AWSResponse ListTags #

Generic ListTags Source # 
Instance details

Defined in Amazonka.Backup.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.Backup.ListTags

Show ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

NFData ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Methods

rnf :: ListTags -> () #

Eq ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Hashable ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Methods

hashWithSalt :: Int -> ListTags -> Int #

hash :: ListTags -> Int #

type AWSResponse ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

type Rep ListTags Source # 
Instance details

Defined in Amazonka.Backup.ListTags

type Rep ListTags = D1 ('MetaData "ListTags" "Amazonka.Backup.ListTags" "amazonka-backup-2.0-LovIt41tphM6jvgQJhTyRf" '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 "resourceArn") '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 - The maximum number of items to be returned.

ListTags, listTags_nextToken - The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

ListTags, listTags_resourceArn - An Amazon Resource Name (ARN) that uniquely identifies a resource. The format of the ARN depends on the type of resource. Valid targets for ListTags are recovery points, backup plans, and backup vaults.

Request Lenses

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

The maximum number of items to be returned.

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

The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

listTags_resourceArn :: Lens' ListTags Text Source #

An Amazon Resource Name (ARN) that uniquely identifies a resource. The format of the ARN depends on the type of resource. Valid targets for ListTags are recovery points, backup plans, and backup vaults.

Destructuring the Response

data ListTagsResponse Source #

See: newListTagsResponse smart constructor.

Constructors

ListTagsResponse' 

Fields

  • nextToken :: Maybe Text

    The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

  • tags :: Maybe (Sensitive (HashMap Text Text))

    To help organize your resources, you can assign your own metadata to the resources you create. Each tag is a key-value pair.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic ListTagsResponse Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Associated Types

type Rep ListTagsResponse :: Type -> Type #

Show ListTagsResponse Source # 
Instance details

Defined in Amazonka.Backup.ListTags

NFData ListTagsResponse Source # 
Instance details

Defined in Amazonka.Backup.ListTags

Methods

rnf :: ListTagsResponse -> () #

Eq ListTagsResponse Source # 
Instance details

Defined in Amazonka.Backup.ListTags

type Rep ListTagsResponse Source # 
Instance details

Defined in Amazonka.Backup.ListTags

type Rep ListTagsResponse = D1 ('MetaData "ListTagsResponse" "Amazonka.Backup.ListTags" "amazonka-backup-2.0-LovIt41tphM6jvgQJhTyRf" '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 (Sensitive (HashMap Text Text)))) :*: 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 - The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

ListTagsResponse, listTagsResponse_tags - To help organize your resources, you can assign your own metadata to the resources you create. Each tag is a key-value pair.

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

Response Lenses

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

The next item following a partial list of returned items. For example, if a request is made to return maxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

listTagsResponse_tags :: Lens' ListTagsResponse (Maybe (HashMap Text Text)) Source #

To help organize your resources, you can assign your own metadata to the resources you create. Each tag is a key-value pair.

listTagsResponse_httpStatus :: Lens' ListTagsResponse Int Source #

The response's http status code.