ListLedgers - Amazon Quantum Ledger-Datenbank (AmazonQLDB)
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

ListLedgers

Gibt alle Ledger zurück, die dem aktuellen Konto AWS-Konto und der Region zugeordnet sind.

Diese Aktion gibt ein Maximum an MaxResults Elementen zurück und ist paginiert, sodass Sie alle Elemente abrufen können, indem Sie sie ListLedgers mehrmals aufrufen.

Anforderungssyntax

GET /ledgers?max_results=MaxResults&next_token=NextToken HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

MaxResults

Die maximale Anzahl von Ergebnissen, die in einer einzigen ListLedgers Anfrage zurückgegeben werden können. (Die tatsächliche Anzahl der zurückgegebenen Ergebnisse ist möglicherweise geringer.)

Gültiger Bereich: Mindestwert 1. Maximalwert 100.

NextToken

Ein Paginierungstoken, das angibt, dass Sie die nächste Ergebnisseite abrufen möchten. Wenn Sie NextToken in der Antwort eines früheren ListLedgers Anrufs einen Wert für erhalten haben, sollten Sie diesen Wert hier als Eingabe verwenden.

Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.

Pattern: ^[A-Za-z-0-9+/=]+$

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "Ledgers": [ 
      { 
         "CreationDateTime": number,
         "Name": "string",
         "State": "string"
      }
   ],
   "NextToken": "string"
}

Antwortelemente

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

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

Ledgers

Die Ledger, die dem aktuellen Konto AWS-Konto und der Region zugeordnet sind.

Typ: Array von LedgerSummary-Objekten

NextToken

Ein Paginierungstoken, das angibt, ob weitere Ergebnisse verfügbar sind:

  • Wenn leer NextToken ist, wurde die letzte Ergebnisseite verarbeitet und es können keine weiteren Ergebnisse abgerufen werden.

  • Wenn nicht leer NextToken ist, sind weitere Ergebnisse verfügbar. Um die nächste Ergebnisseite abzurufen, verwenden Sie den Wert von NextToken in einem nachfolgenden ListLedgers-Aufruf.

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.

Pattern: ^[A-Za-z-0-9+/=]+$

Fehler

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

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: