Amazonka.ResourceGroups.Tag

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

Creating a Request

data Tag

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

ToJSON Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

toJSON :: Tag -> Value

toEncoding :: Tag -> Encoding

toJSONList :: [Tag] -> Value

toEncodingList :: [Tag] -> Encoding

ToHeaders Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

toHeaders :: Tag -> [Header]

ToPath Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

toPath :: Tag -> ByteString

ToQuery Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

toQuery :: Tag -> QueryString

AWSRequest Tag

Defined in Amazonka.ResourceGroups.Tag

Associated Types

type AWSResponse Tag

Methods

request :: (Service -> Service) -> Tag -> Request Tag

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy Tag -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse Tag)))

Generic Tag

Defined in Amazonka.ResourceGroups.Tag

Associated Types

type Rep Tag :: Type -> Type

Methods

from :: Tag -> Rep Tag x

to :: Rep Tag x -> Tag

Read Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

readsPrec :: Int -> ReadS Tag

readList :: ReadS [Tag]

readPrec :: ReadPrec Tag

readListPrec :: ReadPrec [Tag]

Show Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

showsPrec :: Int -> Tag -> ShowS

show :: Tag -> String

showList :: [Tag] -> ShowS

NFData Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

rnf :: Tag -> ()

Eq Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

(==) :: Tag -> Tag -> Bool

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

Hashable Tag

Defined in Amazonka.ResourceGroups.Tag

Methods

hashWithSalt :: Int -> Tag -> Int

hash :: Tag -> Int

type AWSResponse Tag

Defined in Amazonka.ResourceGroups.Tag

type AWSResponse Tag = TagResponse

type Rep Tag

Defined in Amazonka.ResourceGroups.Tag

type Rep Tag = D1 ('MetaData "Tag" "Amazonka.ResourceGroups.Tag" "amazonka-resourcegroups-2.0-B1PbpVYkdAmDCiu1dJFqfU" '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))))

newTag

Arguments

:: Text

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:

Tag, tag_arn - The ARN of the resource group to which to add 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

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

tag_tags :: Lens' Tag (HashMap Text Text)

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

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

Generic TagResponse

Defined in Amazonka.ResourceGroups.Tag

Associated Types

type Rep TagResponse :: Type -> Type

Methods

from :: TagResponse -> Rep TagResponse x

to :: Rep TagResponse x -> TagResponse

Read TagResponse

Defined in Amazonka.ResourceGroups.Tag

Methods

readsPrec :: Int -> ReadS TagResponse

readList :: ReadS [TagResponse]

readPrec :: ReadPrec TagResponse

readListPrec :: ReadPrec [TagResponse]

Show TagResponse

Defined in Amazonka.ResourceGroups.Tag

Methods

showsPrec :: Int -> TagResponse -> ShowS

show :: TagResponse -> String

showList :: [TagResponse] -> ShowS

NFData TagResponse

Defined in Amazonka.ResourceGroups.Tag

Methods

rnf :: TagResponse -> ()

Eq TagResponse

Defined in Amazonka.ResourceGroups.Tag

Methods

(==) :: TagResponse -> TagResponse -> Bool

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

type Rep TagResponse

Defined in Amazonka.ResourceGroups.Tag

type Rep TagResponse = D1 ('MetaData "TagResponse" "Amazonka.ResourceGroups.Tag" "amazonka-resourcegroups-2.0-B1PbpVYkdAmDCiu1dJFqfU" '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

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:

Tag, tagResponse_arn - The ARN of the tagged resource.

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)

The ARN of the tagged resource.

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

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

tagResponse_httpStatus :: Lens' TagResponse Int

The response's http status code.