ListTables - Amazon-DynamoDB

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.

ListTables

Wichtig

Dieser Abschnitt bezieht sich auf die veraltete API-Version 2011-12-05, die nicht für neue Anwendungen verwendet werden sollte.

Eine Dokumentation zur aktuellen Low-Level-API finden Sie in der Amazon DynamoDB-API-Referenz.

Beschreibung

Gibt ein Array aller Tabellen zurück, die dem aktuellen Konto und Endpunkt zugeordnet sind.

Jeder DynamoDB-Endpunkt ist vollständig unabhängig. Wenn Sie beispielsweise zwei Tabellen namens „MyTable“ haben, eine in dynamodb.us-west-2.amazonaws.com und eine in dynamodb.us-east-1.amazonaws.com, sind sie völlig unabhängig und teilen sich keine Daten. Die ListTables-Operation gibt alle Tabellennamen, die mit dem Konto verknüpft sind, von dem die Anforderung stammt, für den Endpunkt, der die Anforderung empfängt, zurück.

Anforderungen

Syntax

// This header is abbreviated. // For a sample of a complete header, see DynamoDB auf niedriger Ebene API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.ListTables content-type: application/x-amz-json-1.0 {"ExclusiveStartTableName":"Table1","Limit":3}

Die ListTables-Operation fordert standardmäßig alle Tabellennamen, die mit dem Konto verknüpft sind, von dem die Anforderung stammt, für den Endpunkt, der die Anforderung empfängt, an.

Name Beschreibung Erforderlich
Limit

Eine Reihe von zurückzugebenden maximalen Tabellennamen.

Typ: Ganzzahl

Nein
ExclusiveStartTableName

Der Name der Tabelle, mit der die Liste beginnt. Wenn Sie bereits eine ListTables-Operation ausgeführt und einen LastEvaluatedTableName-Wert in der Antwort erhalten haben, verwenden Sie diesen Wert, um die Liste fortzuführen.

Typ: Zeichenfolge

Nein

Antworten

Syntax

HTTP/1.1 200 OK x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 81 Date: Fri, 21 Oct 2011 20:35:38 GMT {"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}
Name Beschreibung
TableNames

Die Namen der Tabellen, die dem aktuellen Konto am aktuellen Endpunkt zugeordnet sind.

Typ: Array

LastEvaluatedTableName

Der Name der letzten Tabelle in der aktuellen Liste, sofern einige Tabellen für das Konto und den Endpunkt nicht zurückgegeben wurden. Dieser Wert ist in einer Antwort nicht vorhanden, wenn alle Tabellennamen bereits zurückgegeben wurden. Verwenden Sie diesen Wert als ExclusiveStartTableName in einer neuen Anforderung, um die Liste fortzuführen, bis alle Tabellennamen zurückgegeben werden.

Typ: Zeichenfolge

Spezielle Fehler

Keine Fehler sind für diese Operation spezifisch.

Beispiele

Die folgenden Beispiele zeigen eine HTTP-POST-Anforderung und Antwort mithilfe der ListTables-Operation.

Beispielanforderung

// This header is abbreviated. // For a sample of a complete header, see DynamoDB auf niedriger Ebene API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.ListTables content-type: application/x-amz-json-1.0 {"ExclusiveStartTableName":"comp2","Limit":3}

Beispielantwort

HTTP/1.1 200 OK x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 81 Date: Fri, 21 Oct 2011 20:35:38 GMT {"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}