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

ListJournalKinesisStreamsForLedger

Gibt alle Amazon QLDB-Journal-Streams für ein bestimmtes Ledger zurück.

Diese Aktion gibt keine abgelaufenen Journal-Streams zurück. Weitere Informationen finden Sie unter Ablauf von Terminal-Streams im Amazon QLDB Developer Guide.

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

Anforderungssyntax

GET /ledgers/name/journal-kinesis-streams?max_results=MaxResults&next_token=NextToken HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

name

Der Name des Ledgers.

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

Pattern: (?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

Erforderlich: Ja

MaxResults

Die maximale Anzahl von Ergebnissen, die in einer einzigen ListJournalKinesisStreamsForLedger 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 ListJournalKinesisStreamsForLedger 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

{
   "NextToken": "string",
   "Streams": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorCause": "string",
         "ExclusiveEndTime": number,
         "InclusiveStartTime": number,
         "KinesisConfiguration": { 
            "AggregationEnabled": boolean,
            "StreamArn": "string"
         },
         "LedgerName": "string",
         "RoleArn": "string",
         "Status": "string",
         "StreamId": "string",
         "StreamName": "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.

NextToken

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

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

Typ: Zeichenfolge

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

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

Streams

Die QLDB-Journal-Streams, die derzeit dem angegebenen Ledger zugeordnet sind.

Typ: Array von JournalKinesisStreamDescription-Objekten

Fehler

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

InvalidParameterException

Ein oder mehrere Parameter in der Anfrage sind nicht gültig.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Ressource ist nicht vorhanden.

HTTP Status Code: 404

ResourcePreconditionNotMetException

Der Vorgang ist fehlgeschlagen, weil eine Bedingung nicht im Voraus erfüllt wurde.

HTTP-Statuscode: 412

Weitere Informationen finden Sie unter:

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