ScheduleKeyDeletion#

Description#

Планирует удаление ключа KMS.

Attention

Ключ KMS удаляется безвозвратно. После удаления расшифровать данные, зашифрованные этим ключом KMS, будет невозможно.

Request Parameters#

Required parameters#

  • KeyId — Идентификатор ключа KMS.

    • Type: String

    • Required: Yes

Optional parameters#

  • PendingWindowInDays — Период ожидания перед удалением ключа KMS в днях.

    • Type: Integer

    • Required: No

    • Default value: 30

    • Диапазон: От 7 до 30

Response Elements#

  • DeletionDate — Дата и время, по истечении которых ключ KMS будет удалён.

    • Type: Timestamp

  • KeyState — Текущее состояние ключа KMS.

    • Type: String

    • Возможные значения: Enabled | Disabled | PendingDeletion

  • PendingWindowInDays — Период ожидания перед удалением ключа KMS в днях.

    • Type: Integer

Examples#

Sample Request#

POST / HTTP/1.1
Host: kms.<region>.<domain>
Content-Length: <PayloadSizeBytes>
Content-Type: application/x-amz-json-1.1
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
X-Amz-Date: <Date>
X-Amz-Target: TrentService.ScheduleKeyDeletion

{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "PendingWindowInDays": 7
}

Sample Response#

HTTP/1.1 200 OK
Content-Type: application/x-amz-json-1.1

{
    "DeletionDate": 1777025764.214000,
    "KeyState": "PendingDeletion",
    "PendingWindowInDays": 7
}