Method: projects.locations.endpoints.submitOperationalTransaction

將作業交易提交至網路。只有在交易已複製到網路中的大多數驗證器，或交易失敗時，這個方法才會傳回。

HTTP 要求


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:submitOperationalTransaction

這些網址使用 gRPC 轉碼語法。

路徑參數

參數
endpoint

string

這是必要旗標，提供要求的端點。格式：projects/{project}/locations/{location}/endpoints/{endpoint} 位置是區域。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "serializedSignedOperationalTransaction": string
}
欄位
serializedSignedOperationalTransaction

string (bytes format)

這是必要旗標，要提交至總帳的 protobuf 序列化 SignedTransaction。隨附的客戶交易必須是營運交易，且寄件者必須是平台營運商。使用序列化格式可確保所有驗證器計算出的交易 ID，與序列化位元組的 SHA-256 摘要相同。

Base64 編碼字串。

回應主體

endpoints.submitOperationalTransaction 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "transactionDigestHex": string
}
欄位
transactionDigestHex

string

用於識別提交作業交易的專屬 ID。這是 serializedSignedOperationalTransaction 的 SHA-256 摘要十六進位表示法。提供這個交易 ID 後，用戶端就能追蹤交易，不必自行實作雜湊邏輯。這個 ID 可直接用於後續的 API 呼叫，例如查詢交易狀態。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱Authentication Overview。

IAM 權限

需要 endpoint 資源的下列 IAM 權限：

  • universalledger.endpoints.submit

詳情請參閱 IAM 說明文件。