ScheduleKeyDeletion

GET /?Action=ScheduleKeyDeletion
Description

Schedules the deletion of a customer master key (CMK).
If the request succeeds, the state of the CMK becomes PendingDeletion and the CMK is deleted at the end of a waiting period.

Note

  • You cannot delete the default CMK of your account.

  • You cannot modify the waiting period after you have scheduled the deletion. However, you can cancel the scheduled deletion using the CancelKeyDeletion method.
Body parameter

Required: false
Name: ScheduleKeyDeletionRequest

Name Description Required Schema Default Example

KeyId

The ID of the CMK.

true

string

PendingWindowInDays

The waiting period before deletion, in days (between 7 and 30). By default, 30.

false

integer
Responses
HTTP Code 200
HTTP Code Description Schema

200

ScheduleKeyDeletionResult

Response 200

Response 200

Name Description Required Schema Default Example

DeletionDate

The date and time when the CMK will be deleted.

false

string

KeyId

The ID of the CMK.

false

string