Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# UpdateDatabase
Modifica a AWS KMS chave de um banco de dados existente. Ao atualizar o banco de dados, você deve especificar o nome do banco de dados e o identificador da nova AWS KMS chave a ser usada (`KmsKeyId`). Se houver alguma solicitação simultânea `UpdateDatabase`, o primeiro escritor vence.
Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) para obter detalhes.
## Sintaxe da solicitação
```
{
"DatabaseName": "string",
"KmsKeyId": "string"
}
```
## Parâmetros da solicitação
Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).
A solicitação aceita os dados a seguir no formato JSON.
** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **
O nome do banco de dados.
Tipo: string
Restrições de tamanho: tamanho mínimo 3. O comprimento máximo é 256.
Obrigatório: sim
** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **
O identificador da nova AWS KMS chave (`KmsKeyId`) a ser usada para criptografar os dados armazenados no banco de dados. Se o `KmsKeyId` atualmente registrado no banco de dados for o mesmo que o `KmsKeyId` na solicitação, nenhuma atualização será feita.
Você pode especificar a `KmsKeyId` usando qualquer um dos seguintes itens:
+ ID da chave: `1234abcd-12ab-34cd-56ef-1234567890ab`
+ ARN da chave: `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
+ Nome do alias: `alias/ExampleAlias`
+ ARN do alias: `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias`
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 2048.
Obrigatório: sim
## Sintaxe da resposta
```
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [Database](#API_UpdateDatabase_ResponseSyntax) **
Um contêiner de nível superior para uma mesa. Bancos de dados e tabelas são os conceitos fundamentais de gerenciamento no Amazon Timestream. Todas as tabelas em um banco de dados são criptografadas com a mesma AWS KMS chave.
Tipo: objeto [Database](API_Database.md)
## Erros
Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md).
** AccessDeniedException **
Você não tem autorização para executar esta ação.
Código de status HTTP: 400
** InternalServerException **
O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.
Código de status HTTP: 500
** InvalidEndpointException **
O endpoint solicitado não era válido.
Código de status HTTP: 400
** ResourceNotFoundException **
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO.
Código de status HTTP: 400
** ServiceQuotaExceededException **
A cota de instância do recurso foi excedida para essa conta.
Código de status HTTP: 400
** ThrottlingException **
Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.
Código de status HTTP: 400
** ValidationException **
Uma solicitação inválida ou malformada.
Código de status HTTP: 400
## Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+ [AWS Interface de linha de comando 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)