Une clé maître client (CMK) peut se trouver dans l'un des états suivants : Enabled, Disabled ou PendingDeletion. Une CMK dont le matériel de clé est importé (Bring Your Own Key, ou BYOK) peut également être à l'état PendingImport.
Dans la plupart des cas, une CMK nouvellement créée est à l'état Enabled.
Une CMK basée sur BYOK nouvellement créée est à l'état PendingImport. Pour vérifier si une CMK utilise du matériel de clé importé, appelez DescribeKey et vérifiez que
Origina la valeurEXTERNAL.Seules les CMK à l'état Enabled peuvent effectuer des opérations cryptographiques (chiffrement, déchiffrement ou génération de clés de données).
Une CMK à l'état PendingDeletion est définitivement supprimée à l'issue de la période d'attente planifiée.
Chaque appel d'API renvoie l'un des résultats suivants :
| Résultat | Code d'état HTTP |
|---|---|
Success |
200 |
Rejected.Enabled |
409 |
Rejected.Disabled |
409 |
Rejected.PendingDeletion |
409 |
Rejected.PendingImport |
409 |
Rejected.StateModifiedFailed |
409 |
Opérations d'API courantes
| Opération d'API | Enabled | Disabled | PendingDeletion | PendingImport |
|---|---|---|---|---|
CreateKey |
Success | Success | Success | Success |
GenerateDataKey |
Success | Rejected.Disabled | Rejected.PendingDeletion | Rejected.PendingImport |
GenerateDataKeyWithoutPlaintext |
Success | Rejected.Disabled | Rejected.PendingDeletion | Rejected.PendingImport |
Encrypt |
Success | Rejected.Disabled | Rejected.PendingDeletion | Rejected.PendingImport |
Decrypt |
Success | Rejected.Disabled | Rejected.PendingDeletion | Rejected.PendingImport |
ListKeys |
Success | Success | Success | Success |
DescribeKey |
Success | Success | Success | Success |
UpdateKeyDescription |
Success | Success | Rejected.PendingDeletion | Success |
EnableKey |
Success | Success | Rejected.StateModifiedFailed | Rejected.StateModifiedFailed |
DisableKey |
Success | Success | Rejected.StateModifiedFailed | Rejected.StateModifiedFailed |
ScheduleKeyDeletion |
Success | Success | Rejected.StateModifiedFailed | Success |
CancelKeyDeletion |
Rejected.StateModifiedFailed | Rejected.StateModifiedFailed | Success | Rejected.StateModifiedFailed |
CreateAlias |
Success | Success | Rejected.StateModifiedFailed | Success |
DeleteAlias |
Success | Success | Success | Success |
ListAliases |
Success | Success | Success | Success |
TagResource |
Success | Success | Rejected.PendingDeletion | Success |
UntagResource |
Success | Success | Rejected.PendingDeletion | Success |
ListResourceTags |
Success | Success | Success | Success |
DescribeKeyVersion |
Success | Success | Success | Success |
ListKeyVersions |
Success | Success | Success | Success |
UpdateRotationPolicy |
Success | Rejected.Disabled | Rejected.PendingDeletion | Rejected.PendingImport |
Remarque : L'opération CancelKeyDeletion aboutit uniquement lorsque la CMK est à l'état PendingDeletion, car l'annulation n'est valide que pour les clés déjà programmées pour suppression.
Opérations d'API spéciales
UpdateAlias — le résultat dépend de l'état de la CMK de destination, et non de la CMK source.
| État de la CMK de destination | Résultat |
|---|---|
| Tout état sauf PendingDeletion | Success |
| PendingDeletion | Rejected.PendingDeletion |
Opérations d'API spécifiques à BYOK
Ces opérations s'appliquent uniquement aux CMK dont le matériel de clé est importé (Origin = EXTERNAL).
| Opération d'API | Enabled | Disabled | PendingDeletion | PendingImport |
|---|---|---|---|---|
GetParametersForImport |
Success | Success | Success | Success |
ImportKeyMaterial |
Success | Success | Rejected.StateModifiedFailed | Success |
DeleteKeyMaterial |
Success | Success | Success | Success |