UpdateDatabase - Amazon Timestream

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateDatabase

Modifica la AWS KMS chiave per un database esistente. Durante l'aggiornamento del database, è necessario specificare il nome del database e l'identificatore della nuova AWS KMS chiave da utilizzare ()KmsKeyId. Se ci sono UpdateDatabase richieste simultanee, vince il primo scrittore.

Consulta l'esempio di codice per i dettagli.

Sintassi della richiesta

{ "DatabaseName": "string", "KmsKeyId": "string" }

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

DatabaseName

Nome del database.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.

Campo obbligatorio: sì

KmsKeyId

L'identificatore della nuova AWS KMS chiave (KmsKeyId) da utilizzare per crittografare i dati memorizzati nel database. Se il KmsKeyId valore attualmente registrato nel database è lo stesso indicato KmsKeyId nella richiesta, non ci sarà alcun aggiornamento.

È possibile specificare l'KmsKeyIdutilizzo di uno dei seguenti:

  • ID chiave: 1234abcd-12ab-34cd-56ef-1234567890ab

  • ARN chiave: arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Nome alias: alias/ExampleAlias

  • ARN alias: arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

Campo obbligatorio: sì

Sintassi della risposta

{ "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

Database

Un contenitore di primo livello per una tabella. I database e le tabelle sono i concetti di gestione fondamentali in Amazon Timestream. Tutte le tabelle di un database sono crittografate con la stessa AWS KMS chiave.

Tipo: oggetto Database

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

Non sei autorizzato a eseguire questa azione.

Codice di stato HTTP: 400

InternalServerException

Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.

Codice di stato HTTP: 500

InvalidEndpointException

L'endpoint richiesto non era valido.

Codice di stato HTTP: 400

ResourceNotFoundException

L'operazione ha cercato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il suo stato potrebbe non essere ATTIVO.

Codice di stato HTTP: 400

ServiceQuotaExceededException

La quota di risorse dell'istanza è stata superata per questo account.

Codice di stato HTTP: 400

ThrottlingException

Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.

Codice di stato HTTP: 400

ValidationException

Richiesta non valida o non valida.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: