UpdateDatabase - Amazon Timestream
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

UpdateDatabase

Ändert den AWS KMS Schlüssel für eine bestehende Datenbank. Beim Aktualisieren der Datenbank müssen Sie den Datenbanknamen und die Kennung des neuen AWS KMS Schlüssels angeben, der verwendet werden soll (KmsKeyId). Bei gleichzeitigen UpdateDatabase Anfragen gewinnt der erste Writer.

Einzelheiten finden Sie unter Codebeispiel.

Anforderungssyntax

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

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

DatabaseName

Name der Datenbank.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Ja

KmsKeyId

Die Kennung des neuen AWS KMS Schlüssels (KmsKeyId), der zur Verschlüsselung der in der Datenbank gespeicherten Daten verwendet werden soll. Wenn der KmsKeyId aktuell in der Datenbank registrierte Wert mit dem KmsKeyId in der Anfrage übereinstimmt, erfolgt keine Aktualisierung.

Sie können das KmsKeyId mit einer der folgenden Optionen angeben:

  • Schlüssel-ID: 1234abcd-12ab-34cd-56ef-1234567890ab

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

  • Alias-Name: alias/ExampleAlias

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

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Ja

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

Database

Ein Container der obersten Ebene für eine Tabelle. Datenbanken und Tabellen sind die grundlegenden Verwaltungskonzepte in Amazon Timestream. Alle Tabellen in einer Datenbank sind mit demselben AWS KMS Schlüssel verschlüsselt.

Typ: Database Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

AccessDeniedException

Sie sind nicht berechtigt, diese Aktion auszuführen.

HTTPStatuscode: 400

InternalServerException

Timestream konnte diese Anfrage aufgrund eines internen Serverfehlers nicht vollständig verarbeiten.

HTTPStatuscode: 500

InvalidEndpointException

Der angeforderte Endpunkt war nicht gültig.

HTTPStatuscode: 400

ResourceNotFoundException

Der Vorgang hat versucht, auf eine nicht vorhandene Ressource zuzugreifen. Die Ressource wurde möglicherweise nicht richtig angegeben, oder ihr Status ist nicht ACTIVE korrekt.

HTTPStatuscode: 400

ServiceQuotaExceededException

Das Instanzkontingent der Ressource für dieses Konto wurde überschritten.

HTTPStatuscode: 400

ThrottlingException

Ein Benutzer hat zu viele Anfragen gestellt und sie haben die Servicekontingenten überschritten. Die Anforderung wurde gedrosselt.

HTTPStatuscode: 400

ValidationException

Eine ungültige oder falsch formatierte Anfrage.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: