SendCommand

將命令傳送至 Amazon QLDB 分類帳。

注意

建議您不要直接與此 API 互動，而是使用 QLDB 驅動程式或 QLDB 命令介面在分類帳上執行資料交易。

如果您使用的是 AWS SDK，請使用 QLDB 驅動程式。驅動程式在此 QLDB 工作階段資料 API 上方提供了一個高層級的抽象層，並為您管理SendCommand作業。如需相關資訊和支援的程式設計語言清單，請參閱 Amazon QLDB 開發人員指南中的開始使用驅動程式。
如果您正在使用 AWS Command Line Interface （AWS CLI），請使用 QLDB 外殼。殼層是使用 QLDB 驅動程式與總帳互動的命令列介面。如需相關資訊，請參閱使用 QLDB 殼層存取 Amazon QL DB。

請求語法


{
   "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": { 
   }
}

請求參數

如需所有動作的一般參數資訊，請參閱《Common Parameters》。

請求接受採用 JSON 格式的下列資料。

AbortTransaction

中止目前交易的命令。

類型：AbortTransactionRequest 物件

必要：否

CommitTransaction

命令來提交指定的事務。

類型：CommitTransactionRequest 物件

必要：否

EndSession

結束目前階段作業的指令。

類型：EndSessionRequest 物件

必要：否

ExecuteStatement

在指定的事務中執行語句的命令。

類型：ExecuteStatementRequest 物件

必要：否

FetchPage

獲取頁面的命令。

類型：FetchPageRequest 物件

必要：否

SessionToken

指定目前命令的工作階段權杖。會話令牌在會話的整個生命週期中是恆定的。

若要取得工作階段權杖，請執行StartSession命令。這SessionToken對於在目前作業階段期間發出的每個後續指令都需要這樣做。

類型：字串

長度約束：最小長度為 4。長度上限為 1024。

模式：^[A-Za-z-0-9+/=]+$

必要：否

StartSession

啟動新工作階段的命令。會話令牌作為響應的一部分獲得。

類型：StartSessionRequest 物件

必要：否

StartTransaction

啟動新交易的命令。

類型：StartTransactionRequest 物件

必要：否

回應語法


{
   "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"
   }
}