UpdateDatabase - Amazon Timestream
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. Scopri di più qui.

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: