Network.AWS.KMS.ScheduleKeyDeletion

Schedules the deletion of a customer master key (CMK). You may provide a waiting period, specified in days, before deletion occurs. If you do not provide a waiting period, the default period of 30 days is used. When this operation is successful, the state of the CMK changes to PendingDeletion . Before the waiting period ends, you can use CancelKeyDeletion to cancel the deletion of the CMK. After the waiting period ends, AWS KMS deletes the CMK and all AWS KMS data associated with it, including all aliases that refer to it.

You cannot perform this operation on a CMK in a different AWS account.

Important: Deleting a CMK is a destructive and potentially dangerous operation. When a CMK is deleted, all data that was encrypted under the CMK is rendered unrecoverable. To restrict the use of a CMK without deleting it, use DisableKey .

For more information about scheduling a CMK for deletion, see Deleting Customer Master Keys in the AWS Key Management Service Developer Guide .

Creating a Request

scheduleKeyDeletion

Arguments

:: Text

skdKeyId

-> ScheduleKeyDeletion

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

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

• skdPendingWindowInDays - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the customer master key (CMK). This value is optional. If you include a value, it must be between 7 and 30, inclusive. If you do not include a value, it defaults to 30.
• skdKeyId - The unique identifier of the customer master key (CMK) to delete. 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 .

data ScheduleKeyDeletion

See: scheduleKeyDeletion smart constructor.

Instances

Eq ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

(==) :: ScheduleKeyDeletion -> ScheduleKeyDeletion -> Bool

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

Data ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

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

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

toConstr :: ScheduleKeyDeletion -> Constr

dataTypeOf :: ScheduleKeyDeletion -> DataType

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

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

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

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

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

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

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

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

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

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

Read ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

readsPrec :: Int -> ReadS ScheduleKeyDeletion

readList :: ReadS [ScheduleKeyDeletion]

readPrec :: ReadPrec ScheduleKeyDeletion

readListPrec :: ReadPrec [ScheduleKeyDeletion]

Show ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

showsPrec :: Int -> ScheduleKeyDeletion -> ShowS

show :: ScheduleKeyDeletion -> String

showList :: [ScheduleKeyDeletion] -> ShowS

Generic ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Associated Types

type Rep ScheduleKeyDeletion :: Type -> Type

Methods

from :: ScheduleKeyDeletion -> Rep ScheduleKeyDeletion x

to :: Rep ScheduleKeyDeletion x -> ScheduleKeyDeletion

Hashable ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

hashWithSalt :: Int -> ScheduleKeyDeletion -> Int

hash :: ScheduleKeyDeletion -> Int

ToJSON ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

toJSON :: ScheduleKeyDeletion -> Value

toEncoding :: ScheduleKeyDeletion -> Encoding

toJSONList :: [ScheduleKeyDeletion] -> Value

toEncodingList :: [ScheduleKeyDeletion] -> Encoding

AWSRequest ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Associated Types

type Rs ScheduleKeyDeletion :: Type

Methods

request :: ScheduleKeyDeletion -> Request ScheduleKeyDeletion

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

ToHeaders ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

toHeaders :: ScheduleKeyDeletion -> [Header]

ToPath ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

toPath :: ScheduleKeyDeletion -> ByteString

ToQuery ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

toQuery :: ScheduleKeyDeletion -> QueryString

NFData ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

rnf :: ScheduleKeyDeletion -> ()

type Rep ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

type Rep ScheduleKeyDeletion = D1 (MetaData "ScheduleKeyDeletion" "Network.AWS.KMS.ScheduleKeyDeletion" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "ScheduleKeyDeletion'" PrefixI True) (S1 (MetaSel (Just "_skdPendingWindowInDays") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :*: S1 (MetaSel (Just "_skdKeyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))

type Rs ScheduleKeyDeletion

Defined in Network.AWS.KMS.ScheduleKeyDeletion

type Rs ScheduleKeyDeletion = ScheduleKeyDeletionResponse

Request Lenses

skdPendingWindowInDays :: Lens' ScheduleKeyDeletion (Maybe Natural)

The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the customer master key (CMK). This value is optional. If you include a value, it must be between 7 and 30, inclusive. If you do not include a value, it defaults to 30.

skdKeyId :: Lens' ScheduleKeyDeletion Text

The unique identifier of the customer master key (CMK) to delete. 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 .

Destructuring the Response

scheduleKeyDeletionResponse

Arguments

:: Int

skdrsResponseStatus

-> ScheduleKeyDeletionResponse

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

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

• skdrsKeyId - The unique identifier of the customer master key (CMK) for which deletion is scheduled.
• skdrsDeletionDate - The date and time after which AWS KMS deletes the customer master key (CMK).
• skdrsResponseStatus - -- | The response status code.

data ScheduleKeyDeletionResponse

See: scheduleKeyDeletionResponse smart constructor.

Instances

Eq ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

(==) :: ScheduleKeyDeletionResponse -> ScheduleKeyDeletionResponse -> Bool

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

Data ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

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

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

toConstr :: ScheduleKeyDeletionResponse -> Constr

dataTypeOf :: ScheduleKeyDeletionResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

readsPrec :: Int -> ReadS ScheduleKeyDeletionResponse

readList :: ReadS [ScheduleKeyDeletionResponse]

readPrec :: ReadPrec ScheduleKeyDeletionResponse

readListPrec :: ReadPrec [ScheduleKeyDeletionResponse]

Show ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

showsPrec :: Int -> ScheduleKeyDeletionResponse -> ShowS

show :: ScheduleKeyDeletionResponse -> String

showList :: [ScheduleKeyDeletionResponse] -> ShowS

Generic ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Associated Types

type Rep ScheduleKeyDeletionResponse :: Type -> Type

Methods

from :: ScheduleKeyDeletionResponse -> Rep ScheduleKeyDeletionResponse x

to :: Rep ScheduleKeyDeletionResponse x -> ScheduleKeyDeletionResponse

NFData ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

Methods

rnf :: ScheduleKeyDeletionResponse -> ()

type Rep ScheduleKeyDeletionResponse

Defined in Network.AWS.KMS.ScheduleKeyDeletion

type Rep ScheduleKeyDeletionResponse = D1 (MetaData "ScheduleKeyDeletionResponse" "Network.AWS.KMS.ScheduleKeyDeletion" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "ScheduleKeyDeletionResponse'" PrefixI True) (S1 (MetaSel (Just "_skdrsKeyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_skdrsDeletionDate") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 (MetaSel (Just "_skdrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

skdrsKeyId :: Lens' ScheduleKeyDeletionResponse (Maybe Text)

The unique identifier of the customer master key (CMK) for which deletion is scheduled.

skdrsDeletionDate :: Lens' ScheduleKeyDeletionResponse (Maybe UTCTime)

The date and time after which AWS KMS deletes the customer master key (CMK).

skdrsResponseStatus :: Lens' ScheduleKeyDeletionResponse Int

• - | The response status code.