amazonka-ssm-1.6.1: Amazon Simple Systems Manager (SSM) SDK.

Copyright(c) 2013-2018 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.SSM.AddTagsToResource

Contents

Description

Adds or overwrites one or more tags for the specified resource. Tags are metadata that you can assign to your documents, managed instances, Maintenance Windows, Parameter Store parameters, and patch baselines. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test.

Each resource can have a maximum of 50 tags.

We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters.

For more information about tags, see Tagging Your Amazon EC2 Resources in the Amazon EC2 User Guide .

Synopsis

Creating a Request

addTagsToResource Source #

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

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

  • attrResourceType - Specifies the type of resource you are tagging.
  • attrResourceId - The resource ID you want to tag. Use the ID of the resource. Here are some examples: ManagedInstance: mi-012345abcde MaintenanceWindow: mw-012345abcde PatchBaseline: pb-012345abcde For the Document and Parameter values, use the name of the resource.
  • attrTags - One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string. Important: Do not enter personally identifiable information in this field.

data AddTagsToResource Source #

See: addTagsToResource smart constructor.

Instances
Eq AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Data AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Methods

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

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

toConstr :: AddTagsToResource -> Constr #

dataTypeOf :: AddTagsToResource -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> AddTagsToResource -> AddTagsToResource #

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

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

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

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

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

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

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

Read AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Show AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Generic AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Associated Types

type Rep AddTagsToResource :: Type -> Type #

Hashable AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

ToJSON AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

AWSRequest AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Associated Types

type Rs AddTagsToResource :: Type #

ToHeaders AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

ToPath AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

ToQuery AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

NFData AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Methods

rnf :: AddTagsToResource -> () #

type Rep AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

type Rep AddTagsToResource = D1 (MetaData "AddTagsToResource" "Network.AWS.SSM.AddTagsToResource" "amazonka-ssm-1.6.1-7PbnocxNW5qAr7pEvzAy6Q" False) (C1 (MetaCons "AddTagsToResource'" PrefixI True) (S1 (MetaSel (Just "_attrResourceType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ResourceTypeForTagging) :*: (S1 (MetaSel (Just "_attrResourceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_attrTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [Tag]))))
type Rs AddTagsToResource Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Request Lenses

attrResourceType :: Lens' AddTagsToResource ResourceTypeForTagging Source #

Specifies the type of resource you are tagging.

attrResourceId :: Lens' AddTagsToResource Text Source #

The resource ID you want to tag. Use the ID of the resource. Here are some examples: ManagedInstance: mi-012345abcde MaintenanceWindow: mw-012345abcde PatchBaseline: pb-012345abcde For the Document and Parameter values, use the name of the resource.

attrTags :: Lens' AddTagsToResource [Tag] Source #

One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string. Important: Do not enter personally identifiable information in this field.

Destructuring the Response

addTagsToResourceResponse Source #

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

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

data AddTagsToResourceResponse Source #

See: addTagsToResourceResponse smart constructor.

Instances
Eq AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Data AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Methods

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

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

toConstr :: AddTagsToResourceResponse -> Constr #

dataTypeOf :: AddTagsToResourceResponse -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> AddTagsToResourceResponse -> AddTagsToResourceResponse #

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

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

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

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

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

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

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

Read AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Show AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Generic AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

Associated Types

type Rep AddTagsToResourceResponse :: Type -> Type #

NFData AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

type Rep AddTagsToResourceResponse Source # 
Instance details

Defined in Network.AWS.SSM.AddTagsToResource

type Rep AddTagsToResourceResponse = D1 (MetaData "AddTagsToResourceResponse" "Network.AWS.SSM.AddTagsToResource" "amazonka-ssm-1.6.1-7PbnocxNW5qAr7pEvzAy6Q" True) (C1 (MetaCons "AddTagsToResourceResponse'" PrefixI True) (S1 (MetaSel (Just "_attrrsResponseStatus") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Int)))

Response Lenses