CreateTable - 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.

CreateTable

Fügt einer vorhandenen Datenbank in Ihrem Konto eine neue Tabelle hinzu. In einer AWS-Konto müssen Tabellennamen innerhalb jeder Region mindestens eindeutig sein, wenn sie sich in derselben Datenbank befinden. Möglicherweise haben Sie identische Tabellennamen in derselben Region, wenn sich die Tabellen in separaten Datenbanken befinden. Beim Erstellen der Tabelle müssen Sie den Namen der Tabelle und der Datenbank sowie die Aufbewahrungseigenschaften angeben. Hier gelten Servicekontingente. Einzelheiten finden Sie unter Codebeispiel.

Anforderungssyntax

{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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

Der Name der Timestream-Datenbank.

Typ: Zeichenfolge

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

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Ja

MagneticStoreWriteProperties

Enthält Eigenschaften, die beim Aktivieren von Magnetspeicher-Schreibvorgängen in der Tabelle festgelegt werden können.

Typ: MagneticStoreWriteProperties Objekt

Erforderlich: Nein

RetentionProperties

Die Dauer, für die Ihre Zeitreihendaten im Speicher und im Magnetspeicher gespeichert werden müssen.

Typ: RetentionProperties Objekt

Erforderlich: Nein

Schema

Das Schema der Tabelle.

Typ: Schema Objekt

Erforderlich: Nein

TableName

Der Name der Timestream-Tabelle.

Typ: Zeichenfolge

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

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Ja

Tags

Eine Liste von Schlüssel-Wert-Paaren zur Bezeichnung der Tabelle.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}

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.

Table

Die neu erstellte Timestream-Tabelle.

Typ: Table 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

ConflictException

Timestream konnte diese Anfrage nicht verarbeiten, da sie eine Ressource enthält, die bereits vorhanden ist.

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

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 die Servicekontingente ü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: