Network.AWS.ResourceGroupsTagging.TagResources

Applies one or more tags to the specified resources. Note the following:

• Not all resources can have tags. For a list of resources that support tagging, see Supported Resources in the AWS Resource Groups and Tag Editor User Guide .
• Each resource can have up to 50 tags. For other limits, see Tag Restrictions in the Amazon EC2 User Guide for Linux Instances .
• You can only tag resources that are located in the specified region for the AWS account.
• To add tags to a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for adding tags. For more information, see Obtaining Permissions for Tagging in the AWS Resource Groups and Tag Editor User Guide .

Creating a Request

tagResources

Arguments

:: NonEmpty Text

trResourceARNList

-> TagResources

Creates a value of TagResources with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• trResourceARNList - A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to tag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference .
• trTags - The tags that you want to add to the specified resources. A tag consists of a key and a value that you define.

data TagResources

See: tagResources smart constructor.

Instances

Eq TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

(==) :: TagResources -> TagResources -> Bool

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

Data TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

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

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

toConstr :: TagResources -> Constr

dataTypeOf :: TagResources -> DataType

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

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

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

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

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

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

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

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

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

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

Read TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

readsPrec :: Int -> ReadS TagResources

readList :: ReadS [TagResources]

readPrec :: ReadPrec TagResources

readListPrec :: ReadPrec [TagResources]

Show TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

showsPrec :: Int -> TagResources -> ShowS

show :: TagResources -> String

showList :: [TagResources] -> ShowS

Generic TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Associated Types

type Rep TagResources :: Type -> Type

Methods

from :: TagResources -> Rep TagResources x

to :: Rep TagResources x -> TagResources

Hashable TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

hashWithSalt :: Int -> TagResources -> Int

hash :: TagResources -> Int

ToJSON TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

toJSON :: TagResources -> Value

toEncoding :: TagResources -> Encoding

toJSONList :: [TagResources] -> Value

toEncodingList :: [TagResources] -> Encoding

AWSRequest TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Associated Types

type Rs TagResources :: Type

Methods

request :: TagResources -> Request TagResources

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy TagResources -> ClientResponse -> m (Response TagResources)

ToHeaders TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

toHeaders :: TagResources -> [Header]

ToPath TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

toPath :: TagResources -> ByteString

ToQuery TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

toQuery :: TagResources -> QueryString

NFData TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

rnf :: TagResources -> ()

type Rep TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

type Rep TagResources = D1 (MetaData "TagResources" "Network.AWS.ResourceGroupsTagging.TagResources" "amazonka-resourcegroupstagging-1.6.1-3OURgsuT9tSCPWoEaLBGfy" False) (C1 (MetaCons "TagResources'" PrefixI True) (S1 (MetaSel (Just "_trResourceARNList") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (List1 Text)) :*: S1 (MetaSel (Just "_trTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Map Text Text))))

type Rs TagResources

Defined in Network.AWS.ResourceGroupsTagging.TagResources

type Rs TagResources = TagResourcesResponse

Request Lenses

trResourceARNList :: Lens' TagResources (NonEmpty Text)

A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to tag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference .

trTags :: Lens' TagResources (HashMap Text Text)

The tags that you want to add to the specified resources. A tag consists of a key and a value that you define.

Destructuring the Response

tagResourcesResponse

Arguments

:: Int

trrsResponseStatus

-> TagResourcesResponse

Creates a value of TagResourcesResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• trrsFailedResourcesMap - Details of resources that could not be tagged. An error code, status code, and error message are returned for each failed item.
• trrsResponseStatus - -- | The response status code.

data TagResourcesResponse

See: tagResourcesResponse smart constructor.

Instances

Eq TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

(==) :: TagResourcesResponse -> TagResourcesResponse -> Bool

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

Data TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

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

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

toConstr :: TagResourcesResponse -> Constr

dataTypeOf :: TagResourcesResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

readsPrec :: Int -> ReadS TagResourcesResponse

readList :: ReadS [TagResourcesResponse]

readPrec :: ReadPrec TagResourcesResponse

readListPrec :: ReadPrec [TagResourcesResponse]

Show TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

showsPrec :: Int -> TagResourcesResponse -> ShowS

show :: TagResourcesResponse -> String

showList :: [TagResourcesResponse] -> ShowS

Generic TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Associated Types

type Rep TagResourcesResponse :: Type -> Type

Methods

from :: TagResourcesResponse -> Rep TagResourcesResponse x

to :: Rep TagResourcesResponse x -> TagResourcesResponse

NFData TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

Methods

rnf :: TagResourcesResponse -> ()

type Rep TagResourcesResponse

Defined in Network.AWS.ResourceGroupsTagging.TagResources

type Rep TagResourcesResponse = D1 (MetaData "TagResourcesResponse" "Network.AWS.ResourceGroupsTagging.TagResources" "amazonka-resourcegroupstagging-1.6.1-3OURgsuT9tSCPWoEaLBGfy" False) (C1 (MetaCons "TagResourcesResponse'" PrefixI True) (S1 (MetaSel (Just "_trrsFailedResourcesMap") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Map Text FailureInfo))) :*: S1 (MetaSel (Just "_trrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

trrsFailedResourcesMap :: Lens' TagResourcesResponse (HashMap Text FailureInfo)

Details of resources that could not be tagged. An error code, status code, and error message are returned for each failed item.

trrsResponseStatus :: Lens' TagResourcesResponse Int

• - | The response status code.