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

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS TagResources

readList :: ReadS [TagResources]

readPrec :: ReadPrec TagResources

readListPrec :: ReadPrec [TagResources]

Show TagResources

Methods

showsPrec :: Int -> TagResources -> ShowS

show :: TagResources -> String

showList :: [TagResources] -> ShowS

Generic TagResources

Associated Types

type Rep TagResources :: * -> *

Methods

from :: TagResources -> Rep TagResources x

to :: Rep TagResources x -> TagResources

Hashable TagResources

Methods

hashWithSalt :: Int -> TagResources -> Int

hash :: TagResources -> Int

ToJSON TagResources

Methods

toJSON :: TagResources -> Value

toEncoding :: TagResources -> Encoding

toJSONList :: [TagResources] -> Value

toEncodingList :: [TagResources] -> Encoding

NFData TagResources

Methods

rnf :: TagResources -> ()

AWSRequest TagResources

Associated Types

type Rs TagResources :: *

Methods

request :: TagResources -> Request TagResources

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

ToHeaders TagResources

Methods

toHeaders :: TagResources -> [Header]

ToPath TagResources

Methods

toPath :: TagResources -> ByteString

ToQuery TagResources

Methods

toQuery :: TagResources -> QueryString

type Rep TagResources

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

type Rs 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

Methods

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

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

Data TagResourcesResponse

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

Methods

readsPrec :: Int -> ReadS TagResourcesResponse

readList :: ReadS [TagResourcesResponse]

readPrec :: ReadPrec TagResourcesResponse

readListPrec :: ReadPrec [TagResourcesResponse]

Show TagResourcesResponse

Methods

showsPrec :: Int -> TagResourcesResponse -> ShowS

show :: TagResourcesResponse -> String

showList :: [TagResourcesResponse] -> ShowS

Generic TagResourcesResponse

Associated Types

type Rep TagResourcesResponse :: * -> *

Methods

from :: TagResourcesResponse -> Rep TagResourcesResponse x

to :: Rep TagResourcesResponse x -> TagResourcesResponse

NFData TagResourcesResponse

Methods

rnf :: TagResourcesResponse -> ()

type Rep TagResourcesResponse

type Rep TagResourcesResponse = D1 * (MetaData "TagResourcesResponse" "Network.AWS.ResourceGroupsTagging.TagResources" "amazonka-resourcegroupstagging-1.6.0-5L2Cxw2zEoEKPDJx4TkmLS" False) (C1 * (MetaCons "TagResourcesResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_trrsFailedResourcesMap") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text FailureInfo)))) (S1 * (MetaSel (Just Symbol "_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.