SendCommand - Amazon Quantum Ledger Database (Amazon QLDB)
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.

SendCommand

Sendet einen Befehl an ein Amazon QLDB-Ledger.

Anmerkung

Anstatt direkt mit dieser API zu interagieren, empfehlen wir, den QLDB-Treiber oder die QLDB-Shell zu verwenden, um Datentransaktionen in einem Ledger auszuführen.

  • Wenn Sie mit einem AWS SDK arbeiten, verwenden Sie den QLDB-Treiber. Der Treiber bietet eine abstrakte Ebene über dieser QLDB-Sitzungsdaten-API und verwaltet den SendCommand Vorgang für Sie. Informationen und eine Liste der unterstützten Programmiersprachen finden Sie unter Erste Schritte mit dem Treiber im Amazon QLDB Developer Guide.

  • Wenn Sie mit AWS Command Line Interface (AWS CLI) arbeiten, verwenden Sie die QLDB-Shell. Die Shell ist eine Befehlszeilenschnittstelle, die den QLDB-Treiber verwendet, um mit einem Ledger zu interagieren. Weitere Informationen finden Sie unter Zugreifen auf Amazon QLDB mithilfe der QLDB-Shell.

Anforderungssyntax

{
   "AbortTransaction": { 
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "TransactionId": "string"
   },
   "EndSession": { 
   },
   "ExecuteStatement": { 
      "Parameters": [ 
         { 
            "IonBinary": blob,
            "IonText": "string"
         }
      ],
      "Statement": "string",
      "TransactionId": "string"
   },
   "FetchPage": { 
      "NextPageToken": "string",
      "TransactionId": "string"
   },
   "SessionToken": "string",
   "StartSession": { 
      "LedgerName": "string"
   },
   "StartTransaction": { 
   }
}

Anforderungsparameter

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AbortTransaction

Befehl zum Abbrechen der aktuellen Transaktion.

Typ: AbortTransactionRequest Objekt

Erforderlich: Nein

CommitTransaction

Befehl zum Festschreiben der angegebenen Transaktion.

Typ: CommitTransactionRequest Objekt

Erforderlich: Nein

EndSession

Befehl zum Beenden der aktuellen Sitzung.

Typ: EndSessionRequest Objekt

Erforderlich: Nein

ExecuteStatement

Befehl zum Ausführen einer Anweisung in der angegebenen Transaktion.

Typ: ExecuteStatementRequest Objekt

Erforderlich: Nein

FetchPage

Befehl zum Abrufen einer Seite.

Typ: FetchPageRequest Objekt

Erforderlich: Nein

SessionToken

Gibt das Sitzungstoken für den aktuellen Befehl an. Ein Sitzungstoken ist während der gesamten Dauer der Sitzung konstant.

Führen Sie den StartSession Befehl aus, um ein Sitzungstoken zu erhalten. Dies SessionToken ist für jeden nachfolgenden Befehl erforderlich, der während der aktuellen Sitzung ausgegeben wird.

Typ: Zeichenfolge

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

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

Erforderlich: Nein

StartSession

Befehl zum Starten einer neuen Sitzung. Ein Sitzungstoken wird als Teil der Antwort abgerufen.

Typ: StartSessionRequest Objekt

Erforderlich: Nein

StartTransaction

Befehl zum Starten einer neuen Transaktion.

Typ: StartTransactionRequest Objekt

Erforderlich: Nein

Antwortsyntax

{
   "AbortTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "string"
   },
   "EndSession": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "ExecuteStatement": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "FirstPage": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "FetchPage": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "Page": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartSession": { 
      "SessionToken": "string",
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "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.

AbortTransaction

Enthält die Details der abgebrochenen Transaktion.

Typ: AbortTransactionResult Objekt

CommitTransaction

Enthält die Details der festgeschriebenen Transaktion.

Typ: CommitTransactionResult Objekt

EndSession

Enthält die Details der beendeten Sitzung.

Typ: EndSessionResult Objekt

ExecuteStatement

Enthält die Details der ausgeführten Anweisung.

Typ: ExecuteStatementResult Objekt

FetchPage

Enthält die Details der abgerufenen Seite.

Typ: FetchPageResult Objekt

StartSession

Enthält die Details der gestarteten Sitzung, die ein Sitzungstoken enthält. Dies SessionToken ist für jeden nachfolgenden Befehl erforderlich, der während der aktuellen Sitzung ausgegeben wird.

Typ: StartSessionResult Objekt

StartTransaction

Enthält die Details der gestarteten Transaktion.

Typ: StartTransactionResult Objekt

Fehler

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

BadRequestException

Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.

HTTP Status Code: 400

CapacityExceededException

Wird zurückgegeben, wenn die Anfrage die Verarbeitungskapazität des Ledgers überschreitet.

HTTP Status Code: 400

InvalidSessionException

Wird zurückgegeben, wenn die Sitzung nicht mehr existiert, weil das Zeitlimit überschritten wurde oder sie abgelaufen ist.

HTTP Status Code: 400

LimitExceededException

Wird zurückgegeben, wenn ein Ressourcenlimit, z. B. die Anzahl der aktiven Sitzungen, überschritten wird.

HTTP Status Code: 400

OccConflictException

Wird zurückgegeben, wenn eine Transaktion aufgrund eines Fehlers in der Überprüfungsphase von Optimistic Concurrency Control (OCC) nicht in das Journal geschrieben werden kann.

HTTP Status Code: 400

RateExceededException

Wird zurückgegeben, wenn die Anzahl der Anfragen den zulässigen Durchsatz überschreitet.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

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