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 UpdateDatabase solicitação simultânea, o primeiro escritor vence.
Consulte a amostra de código 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.
A solicitação aceita os dados a seguir no formato JSON.
- DatabaseName
-
O nome do banco de dados.
Tipo: string
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 256.
Obrigatório: sim
- KmsKeyId
-
O identificador da nova AWS KMS chave (
KmsKeyId) a ser usada para criptografar os dados armazenados no banco de dados. Se o cadastradoKmsKeyIdatualmenteKmsKeyIdno banco de dados for o mesmo da solicitação, não haverá nenhuma atualização.Você pode especificar o
KmsKeyIdusando qualquer um dos seguintes:-
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. Tamanho máximo de 2.048.
Exigido: 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.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não está autorizado a realizar essa 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:
