Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ResourceGroups.Tag

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Adds tags to a resource group with the specified ARN. Existing tags on a resource group are not changed if they are not specified in the request parameters.

Do not store personally identifiable information (PII) or other confidential or sensitive information in tags. We use tags to provide you with billing and administration services. Tags are not intended to be used for private or sensitive data.

Minimum permissions

To run this command, you must have the following permissions:

```
resource-groups:Tag
```

Synopsis

data Tag = Tag' {
- arn :: Text
- tags :: HashMap Text Text
}
newTag :: Text -> Tag
tag_arn :: Lens' Tag Text
tag_tags :: Lens' Tag (HashMap Text Text)
data TagResponse = TagResponse' {
- arn :: Maybe Text
- tags :: Maybe (HashMap Text Text)
- httpStatus :: Int
}
newTagResponse :: Int -> TagResponse
tagResponse_arn :: Lens' TagResponse (Maybe Text)
tagResponse_tags :: Lens' TagResponse (Maybe (HashMap Text Text))
tagResponse_httpStatus :: Lens' TagResponse Int

Creating a Request

data Tag Source #

See: newTag smart constructor.

Constructors

Tag'
Fields arn :: Text The ARN of the resource group to which to add tags. tags :: HashMap Text Text The tags to add to the specified resource group. A tag is a string-to-string map of key-value pairs.

Instances

Instances details

Eq Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods (==) :: Tag -> Tag -> Bool # (/=) :: Tag -> Tag -> Bool #
Read Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods readsPrec :: Int -> ReadS Tag # readList :: ReadS [Tag] # readPrec :: ReadPrec Tag # readListPrec :: ReadPrec [Tag] #
Show Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods showsPrec :: Int -> Tag -> ShowS # show :: Tag -> String # showList :: [Tag] -> ShowS #
Generic Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Associated Types type Rep Tag :: Type -> Type # Methods from :: Tag -> Rep Tag x # to :: Rep Tag x -> Tag #
NFData Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods rnf :: Tag -> () #
Hashable Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods hashWithSalt :: Int -> Tag -> Int # hash :: Tag -> Int #
ToJSON Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods toJSON :: Tag -> Value # toEncoding :: Tag -> Encoding # toJSONList :: [Tag] -> Value # toEncodingList :: [Tag] -> Encoding #
AWSRequest Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Associated Types type AWSResponse Tag # Methods request :: Tag -> Request Tag # response :: MonadResource m => Logger -> Service -> Proxy Tag -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse Tag))) #
ToHeaders Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods toHeaders :: Tag -> [Header] #
ToPath Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods toPath :: Tag -> ByteString #
ToQuery Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods toQuery :: Tag -> QueryString #
type Rep Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag type Rep Tag = D1 ('MetaData "Tag" "Amazonka.ResourceGroups.Tag" "libZSservicesZSamazonka-resourcegroupsZSamazonka-resourcegroups" 'False) (C1 ('MetaCons "Tag'" 'PrefixI 'True) (S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (HashMap Text Text))))
type AWSResponse Tag Source #
Instance details Defined in Amazonka.ResourceGroups.Tag type AWSResponse Tag = TagResponse

newTag Source #

Arguments

:: Text	`$sel:arn:Tag'`
-> Tag

Create a value of Tag 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:arn:Tag', tag_arn - The ARN of the resource group to which to add tags.

$sel:tags:Tag', tag_tags - The tags to add to the specified resource group. A tag is a string-to-string map of key-value pairs.

Request Lenses

tag_arn :: Lens' Tag Text Source #

The ARN of the resource group to which to add tags.

tag_tags :: Lens' Tag (HashMap Text Text) Source #

The tags to add to the specified resource group. A tag is a string-to-string map of key-value pairs.

Destructuring the Response

data TagResponse Source #

See: newTagResponse smart constructor.

Constructors

TagResponse'
Fields arn :: Maybe Text The ARN of the tagged resource. tags :: Maybe (HashMap Text Text) The tags that have been added to the specified resource group. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods (==) :: TagResponse -> TagResponse -> Bool # (/=) :: TagResponse -> TagResponse -> Bool #
Read TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods readsPrec :: Int -> ReadS TagResponse # readList :: ReadS [TagResponse] # readPrec :: ReadPrec TagResponse # readListPrec :: ReadPrec [TagResponse] #
Show TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods showsPrec :: Int -> TagResponse -> ShowS # show :: TagResponse -> String # showList :: [TagResponse] -> ShowS #
Generic TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Associated Types type Rep TagResponse :: Type -> Type # Methods from :: TagResponse -> Rep TagResponse x # to :: Rep TagResponse x -> TagResponse #
NFData TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag Methods rnf :: TagResponse -> () #
type Rep TagResponse Source #
Instance details Defined in Amazonka.ResourceGroups.Tag type Rep TagResponse = D1 ('MetaData "TagResponse" "Amazonka.ResourceGroups.Tag" "libZSservicesZSamazonka-resourcegroupsZSamazonka-resourcegroups" 'False) (C1 ('MetaCons "TagResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newTagResponse Source #

Arguments

:: Int	`$sel:httpStatus:TagResponse'`
-> TagResponse

Create a value of TagResponse 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:arn:Tag', tagResponse_arn - The ARN of the tagged resource.

$sel:tags:Tag', tagResponse_tags - The tags that have been added to the specified resource group.

$sel:httpStatus:TagResponse', tagResponse_httpStatus - The response's http status code.

Response Lenses

tagResponse_arn :: Lens' TagResponse (Maybe Text) Source #

The ARN of the tagged resource.

tagResponse_tags :: Lens' TagResponse (Maybe (HashMap Text Text)) Source #

The tags that have been added to the specified resource group.

tagResponse_httpStatus :: Lens' TagResponse Int Source #

The response's http status code.