Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
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 solicitudes `UpdateDatabase` simultáneas, gana el primer escritor.
Consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) 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](CommonParameters.md).
La solicitud acepta los siguientes datos en formato JSON.
** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **
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](#API_UpdateDatabase_RequestSyntax) **
El identificador de la nueva AWS KMS clave (`KmsKeyId`) que se utilizará para cifrar los datos almacenados en la base de datos. Si el registro `KmsKeyId` actual en la base de datos es el mismo que el `KmsKeyId` de la solicitud, no habrá ninguna actualización.
Puede especificar la `KmsKeyId` mediante alguno de los métodos siguientes:
+ ID de clave: `1234abcd-12ab-34cd-56ef-1234567890ab`
+ ARN de clave: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
+ Nombre de alias: `alias/ExampleAlias`
+ ARN de alias: `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 HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Database](#API_UpdateDatabase_ResponseSyntax) **
Un contenedor de nivel superior para una tabla. Las bases de datos y las tablas son los conceptos de administración fundamentales de Amazon Timestream. Todas las tablas de una base de datos se cifran con la misma AWS KMS clave.
Tipo: objeto [Database](API_Database.md)
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).
** AccessDeniedException **
No tiene autorización para realizar esta acción.
Código de estado HTTP: 400
** InternalServerException **
Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.
Código de estado HTTP: 500
** InvalidEndpointException **
El punto de conexión solicitado no era válido.
Código de estado HTTP: 400
** ResourceNotFoundException **
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.
Código de estado HTTP: 400
** ServiceQuotaExceededException **
Se superó la cuota de recursos de la instancia para esta cuenta.
Código de estado HTTP: 400
** ThrottlingException **
Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.
Código de estado HTTP: 400
** ValidationException **
Solicitud no válida o con formato incorrecto.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase)