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

Amazonka.KMS.UntagResource

Description

Deletes tags from a customer managed key. To delete a tag, specify the tag key and the KMS key.

Tagging or untagging a KMS key can allow or deny permission to the KMS key. For details, see Using ABAC in KMS in the Key Management Service Developer Guide.

When it succeeds, the UntagResource operation doesn't return any output. Also, if the specified tag key isn't found on the KMS key, it doesn't throw an exception or return a response. To confirm that the operation worked, use the ListResourceTags operation.

For information about using tags in KMS, see Tagging keys. For general information about tags, including the format and syntax, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference.

The KMS key that you use for this operation must be in a compatible key state. For details, see Key state: Effect on your KMS key in the Key Management Service Developer Guide.

Cross-account use: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.

Required permissions: kms:UntagResource (key policy)

Related operations

  • CreateKey
  • ListResourceTags
  • ReplicateKey
  • TagResource
Synopsis

Creating a Request

data UntagResource Source #

See: newUntagResource smart constructor.

Constructors

UntagResource' 

Fields

  • keyId :: Text

    Identifies the KMS key from which you are removing tags.

    Specify the key ID or key ARN of the KMS key.

    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 KMS key, use ListKeys or DescribeKey.

  • tagKeys :: [Text]

    One or more tag keys. Specify only the tag keys, not the tag values.

Instances

Instances details
Eq UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

(==) :: UntagResource -> UntagResource -> Bool #

(/=) :: UntagResource -> UntagResource -> Bool #

Read UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

readsPrec :: Int -> ReadS UntagResource #

readList :: ReadS [UntagResource] #

readPrec :: ReadPrec UntagResource #

readListPrec :: ReadPrec [UntagResource] #

Show UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

showsPrec :: Int -> UntagResource -> ShowS #

show :: UntagResource -> String #

showList :: [UntagResource] -> ShowS #

Generic UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Associated Types

type Rep UntagResource :: Type -> Type #

Methods

from :: UntagResource -> Rep UntagResource x #

to :: Rep UntagResource x -> UntagResource #

NFData UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

rnf :: UntagResource -> () #

Hashable UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

hashWithSalt :: Int -> UntagResource -> Int #

hash :: UntagResource -> Int #

ToJSON UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

toJSON :: UntagResource -> Value #

toEncoding :: UntagResource -> Encoding #

toJSONList :: [UntagResource] -> Value #

toEncodingList :: [UntagResource] -> Encoding #

AWSRequest UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Associated Types

type AWSResponse UntagResource #

Methods

request :: UntagResource -> Request UntagResource #

response :: MonadResource m => Logger -> Service -> Proxy UntagResource -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse UntagResource))) #

ToHeaders UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

toHeaders :: UntagResource -> [Header] #

ToPath UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

toPath :: UntagResource -> ByteString #

ToQuery UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

toQuery :: UntagResource -> QueryString #

type Rep UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

type Rep UntagResource = D1 ('MetaData "UntagResource" "Amazonka.KMS.UntagResource" "libZSservicesZSamazonka-kmsZSamazonka-kms" 'False) (C1 ('MetaCons "UntagResource'" 'PrefixI 'True) (S1 ('MetaSel ('Just "keyId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "tagKeys") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text])))
type AWSResponse UntagResource Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

type AWSResponse UntagResource = UntagResourceResponse

newUntagResource Source #

Arguments

:: Text

$sel:keyId:UntagResource'

-> UntagResource 

Create a value of UntagResource 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:

$sel:keyId:UntagResource', untagResource_keyId - Identifies the KMS key from which you are removing tags.

Specify the key ID or key ARN of the KMS key.

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 KMS key, use ListKeys or DescribeKey.

$sel:tagKeys:UntagResource', untagResource_tagKeys - One or more tag keys. Specify only the tag keys, not the tag values.

Request Lenses

untagResource_keyId :: Lens' UntagResource Text Source #

Identifies the KMS key from which you are removing tags.

Specify the key ID or key ARN of the KMS key.

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 KMS key, use ListKeys or DescribeKey.

untagResource_tagKeys :: Lens' UntagResource [Text] Source #

One or more tag keys. Specify only the tag keys, not the tag values.

Destructuring the Response

data UntagResourceResponse Source #

See: newUntagResourceResponse smart constructor.

Constructors

UntagResourceResponse' 

Instances

Instances details
Eq UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

(==) :: UntagResourceResponse -> UntagResourceResponse -> Bool #

(/=) :: UntagResourceResponse -> UntagResourceResponse -> Bool #

Read UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

readsPrec :: Int -> ReadS UntagResourceResponse #

readList :: ReadS [UntagResourceResponse] #

readPrec :: ReadPrec UntagResourceResponse #

readListPrec :: ReadPrec [UntagResourceResponse] #

Show UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

showsPrec :: Int -> UntagResourceResponse -> ShowS #

show :: UntagResourceResponse -> String #

showList :: [UntagResourceResponse] -> ShowS #

Generic UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Associated Types

type Rep UntagResourceResponse :: Type -> Type #

Methods

from :: UntagResourceResponse -> Rep UntagResourceResponse x #

to :: Rep UntagResourceResponse x -> UntagResourceResponse #

NFData UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

Methods

rnf :: UntagResourceResponse -> () #

type Rep UntagResourceResponse Source # 
Instance details

Defined in Amazonka.KMS.UntagResource

type Rep UntagResourceResponse = D1 ('MetaData "UntagResourceResponse" "Amazonka.KMS.UntagResource" "libZSservicesZSamazonka-kmsZSamazonka-kms" 'False) (C1 ('MetaCons "UntagResourceResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newUntagResourceResponse :: UntagResourceResponse Source #

Create a value of UntagResourceResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.