Tous les produits
Search
Centre de documentation

:ScheduleKeyDeletion

Dernière mise à jour :Aug 06, 2026

Supprime une clé principale client (CMK) spécifiée.

Description de l'opération

Pendant la période programmée, la CMK est dans l'état PendingDeletion et ne peut pas être utilisée pour chiffrer des données, déchiffrer des données ou générer des clés de données.

Une fois qu'une CMK est supprimée, elle ne peut plus être récupérée. Les données chiffrées et les clés de données générées au moyen de la CMK ne peuvent plus être déchiffrées. Pour éviter la suppression accidentelle des CMK, Key Management Service (KMS) vous permet uniquement de programmer des tâches de suppression de clés. Vous ne pouvez pas supprimer directement les CMK. Si vous souhaitez supprimer une CMK, appelez l'opération DisableKey pour désactiver la CMK.

Lorsque vous appelez cette opération, vous devez spécifier une période programmée comprise entre 7 et 366 jours. La période programmée commence à partir du moment où vous soumettez la requête. Vous pouvez appeler l'opération CancelKeyDeletion pour annuler la tâche de suppression de clé avant la fin de la période programmée.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

KeyId

string

Oui

L'identifiant de la clé principale client (CMK). L'identifiant doit être globalement unique.

7906979c-8e06-46a2-be2d-68e3ccbc****

PendingWindowInDays

integer

Oui

La période programmée après laquelle la CMK est supprimée. Pendant cette période, la CMK est dans l'état PendingDeletion. Une fois cette période terminée, vous ne pouvez plus annuler la tâche de suppression de clé.

Valeurs valides : 7 à 366.

Unité : jours.

7

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête, qui permet de localiser et de résoudre les problèmes.

3da5b8cc-8107-40ac-a170-793cd181d7b7

Exemples

JSON format

{
  "RequestId": "3da5b8cc-8107-40ac-a170-793cd181d7b7"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.