Impacto del estado de la CMK en las operaciones de API - Key Management Service

Una clave maestra de cliente (CMK) puede encontrarse en uno de los siguientes estados: Enabled, Disabled o PendingDeletion. Si la CMK utiliza material de clave importado (Bring Your Own Key, o BYOK), también puede estar en el estado PendingImport.

En la mayoría de los casos, una CMK recién creada inicia en el estado Enabled.
Una CMK basada en BYOK recién creada inicia en el estado PendingImport. Para comprobar si una CMK usa material de clave importado, llame a DescribeKey y compruebe que Origin sea EXTERNAL.
Solo las CMK en estado Enabled permiten ejecutar operaciones criptográficas, como cifrar datos, descifrar datos o generar claves de datos.
Una CMK en estado PendingDeletion se elimina de forma permanente cuando transcurre el periodo de espera programado.

Cada llamada a la API devuelve uno de los resultados a continuación:

Resultado	Código de estado HTTP
`Success`	200
`Rejected.Enabled`	409
`Rejected.Disabled`	409
`Rejected.PendingDeletion`	409
`Rejected.PendingImport`	409
`Rejected.StateModifiedFailed`	409

Operaciones de API comunes

Operación de 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

Nota: CancelKeyDeletion se ejecuta correctamente solo cuando la CMK se encuentra en el estado PendingDeletion, ya que la cancelación únicamente aplica para claves cuya eliminación ya está programada.

Operaciones de API especiales

UpdateAlias: el resultado depende del estado de la CMK de destino, no de la CMK de origen.

Estado de la CMK de destino	Resultado
Cualquier estado excepto PendingDeletion	Success
PendingDeletion	Rejected.PendingDeletion

Operaciones de API específicas de BYOK

Estas operaciones aplican exclusivamente a las CMK con material de clave importado (Origin = EXTERNAL).

Operación de API	Enabled	Disabled	PendingDeletion	PendingImport
`GetParametersForImport`	Success	Success	Success	Success
`ImportKeyMaterial`	Success	Success	Rejected.StateModifiedFailed	Success
`DeleteKeyMaterial`	Success	Success	Success	Success