Actualiza la política de rotación automática de una CMK.
Descripción de la operación
Cuando la rotación automática de claves está habilitada, KMS crea automáticamente una versión de clave al cumplirse el período de rotación preestablecido. Además, KMS establece la nueva versión de clave como la versión de clave principal.
No se puede configurar una política de rotación automática de claves para las siguientes claves:
-
Clave asimétrica.
-
Clave administrada por el servicio.
-
Clave propia (BYOK) importada a KMS.
-
Clave que no se encuentra en estado Enabled
En este ejemplo, se habilita la rotación automática de claves para una CMK cuyo ID es 1234abcd-12ab-34cd-56ef-12345678****. El período de rotación automática es de 30 días.
Para obtener más información sobre la política de acceso requerida para que un usuario RAM o un rol RAM invoque esta API, consulte Resource Access Management.
Pruébelo ahora
Test
Autorización de RAM
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| KeyId |
string |
Sí |
El ID de la clave maestra del cliente (CMK). El ID debe ser único a nivel global. |
1234abcd-12ab-34cd-56ef-12345678**** |
| EnableAutomaticRotation |
boolean |
Sí |
Especifica si se debe habilitar la rotación automática de claves. Valores válidos:
|
true |
| RotationInterval |
string |
No |
El período de rotación automática de claves. Especifique el valor en formato entero[unidad]. Se admiten las siguientes unidades: d (día), h (hora), m (minuto) y s (segundo). Por ejemplo, puede usar 7d o 604800s para especificar un período de siete días. El período puede oscilar entre 7 días y 730 días. Nota
Si establece el parámetro EnableAutomaticRotation en true, también debe especificar este parámetro. Si establece el parámetro EnableAutomaticRotation en false, puede omitir este parámetro. |
30d |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
|||
| RequestId |
string |
El ID de la solicitud. |
efb1cbbd-a093-4278-bc03-639dd4fcc207 |
Ejemplos
Respuesta exitosa
JSON Formato
{
"RequestId": "efb1cbbd-a093-4278-bc03-639dd4fcc207"
}Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|---|---|---|---|
| 400 | Rejected.UnsupportedOperation | Unsupported operation. | The operation is not supported. |
| 400 | InvalidParameter | The specified parameter RotationInterval is not valid. | Invalid RotationInterval parameter value. |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | The error message returned because the specified CMK does not exist. |
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.