Network.AWS.KMS.TagResource

Adds or overwrites one or more tags for the specified customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty (null) strings.

You cannot use the same tag key more than once per CMK. For example, consider a CMK with one tag whose tag key is Purpose and tag value is Test . If you send a TagResource request for this CMK with a tag key of Purpose and a tag value of Prod , it does not create a second tag. Instead, the original tag is overwritten with the new tag value.

For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User Guide .

Creating a Request

tagResource

Arguments

:: Text

trKeyId

-> TagResource

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

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

• trKeyId - A unique identifier for the CMK you are tagging. Specify the key ID or the Amazon Resource Name (ARN) of the CMK. For example: * Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab * Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey .
• trTags - One or more tags. Each tag consists of a tag key and a tag value.

data TagResource

See: tagResource smart constructor.

Instances

Eq TagResource

Defined in Network.AWS.KMS.TagResource

Methods

(==) :: TagResource -> TagResource -> Bool

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

Data TagResource

Defined in Network.AWS.KMS.TagResource

Methods

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

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

toConstr :: TagResource -> Constr

dataTypeOf :: TagResource -> DataType

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

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

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

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

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

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

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

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

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

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

Read TagResource

Defined in Network.AWS.KMS.TagResource

Methods

readsPrec :: Int -> ReadS TagResource

readList :: ReadS [TagResource]

readPrec :: ReadPrec TagResource

readListPrec :: ReadPrec [TagResource]

Show TagResource

Defined in Network.AWS.KMS.TagResource

Methods

showsPrec :: Int -> TagResource -> ShowS

show :: TagResource -> String

showList :: [TagResource] -> ShowS

Generic TagResource

Defined in Network.AWS.KMS.TagResource

Associated Types

type Rep TagResource :: Type -> Type

Methods

from :: TagResource -> Rep TagResource x

to :: Rep TagResource x -> TagResource

Hashable TagResource

Defined in Network.AWS.KMS.TagResource

Methods

hashWithSalt :: Int -> TagResource -> Int

hash :: TagResource -> Int

ToJSON TagResource

Defined in Network.AWS.KMS.TagResource

Methods

toJSON :: TagResource -> Value

toEncoding :: TagResource -> Encoding

toJSONList :: [TagResource] -> Value

toEncodingList :: [TagResource] -> Encoding

AWSRequest TagResource

Defined in Network.AWS.KMS.TagResource

Associated Types

type Rs TagResource :: Type

Methods

request :: TagResource -> Request TagResource

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

ToHeaders TagResource

Defined in Network.AWS.KMS.TagResource

Methods

toHeaders :: TagResource -> [Header]

ToPath TagResource

Defined in Network.AWS.KMS.TagResource

Methods

toPath :: TagResource -> ByteString

ToQuery TagResource

Defined in Network.AWS.KMS.TagResource

Methods

toQuery :: TagResource -> QueryString

NFData TagResource

Defined in Network.AWS.KMS.TagResource

Methods

rnf :: TagResource -> ()

type Rep TagResource

Defined in Network.AWS.KMS.TagResource

type Rep TagResource = D1 (MetaData "TagResource" "Network.AWS.KMS.TagResource" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "TagResource'" PrefixI True) (S1 (MetaSel (Just "_trKeyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_trTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [Tag])))

type Rs TagResource

Defined in Network.AWS.KMS.TagResource

type Rs TagResource = TagResourceResponse

Request Lenses

trKeyId :: Lens' TagResource Text

A unique identifier for the CMK you are tagging. Specify the key ID or the Amazon Resource Name (ARN) of the CMK. For example: * Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab * Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey .

trTags :: Lens' TagResource [Tag]

One or more tags. Each tag consists of a tag key and a tag value.

Destructuring the Response

tagResourceResponse :: TagResourceResponse

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

data TagResourceResponse

See: tagResourceResponse smart constructor.

Instances

Eq TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Methods

(==) :: TagResourceResponse -> TagResourceResponse -> Bool

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

Data TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Methods

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

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

toConstr :: TagResourceResponse -> Constr

dataTypeOf :: TagResourceResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Methods

readsPrec :: Int -> ReadS TagResourceResponse

readList :: ReadS [TagResourceResponse]

readPrec :: ReadPrec TagResourceResponse

readListPrec :: ReadPrec [TagResourceResponse]

Show TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Methods

showsPrec :: Int -> TagResourceResponse -> ShowS

show :: TagResourceResponse -> String

showList :: [TagResourceResponse] -> ShowS

Generic TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Associated Types

type Rep TagResourceResponse :: Type -> Type

Methods

from :: TagResourceResponse -> Rep TagResourceResponse x

to :: Rep TagResourceResponse x -> TagResourceResponse

NFData TagResourceResponse

Defined in Network.AWS.KMS.TagResource

Methods

rnf :: TagResourceResponse -> ()

type Rep TagResourceResponse

Defined in Network.AWS.KMS.TagResource

type Rep TagResourceResponse = D1 (MetaData "TagResourceResponse" "Network.AWS.KMS.TagResource" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "TagResourceResponse'" PrefixI False) (U1 :: Type -> Type))