Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
UpdateDatabase
Modifica la AWS KMS clave de una base de datos existente. Al actualizar la base de datos, debe especificar el nombre de la base de datos y el identificador de la nueva AWS KMS clave que se va a utilizar (KmsKeyId). Si hay UpdateDatabase solicitudes simultáneas, gana el primer escritor.
Consulte el ejemplo de código para obtener más detalles.
Sintaxis de la solicitud
{
"DatabaseName": "string",
"KmsKeyId": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en JSON formato.
- DatabaseName
-
El nombre de la base de datos.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.
Obligatorio: sí
- KmsKeyId
-
El identificador de la nueva AWS KMS clave (
KmsKeyId) que se utilizará para cifrar los datos almacenados en la base de datos. Si la informaciónKmsKeyIdactualmente registradaKmsKeyIden la base de datos es la misma que la de la solicitud, no habrá ninguna actualización.Puede especificarlo
KmsKeyIdmediante cualquiera de las siguientes opciones:-
ID de clave:
1234abcd-12ab-34cd-56ef-1234567890ab -
ClaveARN:
arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab -
Nombre de alias:
alias/ExampleAlias -
AliasARN:
arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Obligatorio: sí
-
Sintaxis de la respuesta
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No está autorizado a realizar esta acción.
HTTPCódigo de estado: 400
- InternalServerException
-
Timestream no pudo procesar completamente esta solicitud debido a un error interno del servidor.
HTTPCódigo de estado: 500
- InvalidEndpointException
-
El punto final solicitado no era válido.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
La operación intentó acceder a un recurso inexistente. Es posible que el recurso no esté especificado correctamente o que su estado no lo estéACTIVE.
HTTPCódigo de estado: 400
- ServiceQuotaExceededException
-
Se ha superado la cuota de recursos de la instancia para esta cuenta.
HTTPCódigo de estado: 400
- ThrottlingException
-
Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.
HTTPCódigo de estado: 400
- ValidationException
-
Solicitud no válida o mal formada.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
