Method: projects.locations.endpoints.submitOperationalTransaction

運用トランザクションをネットワークに送信します。このメソッドは、トランザクションがネットワーク内の大部分のバリデータに複製された後、またはトランザクションが失敗した場合にのみ返されます。

HTTP リクエスト


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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
endpoint

string

必須。リクエストを処理するエンドポイント。形式: projects/{project}/locations/{location}/endpoints/{endpoint}。ロケーションはリージョンです。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "serializedSignedOperationalTransaction": string
}
フィールド
serializedSignedOperationalTransaction

string (bytes format)

必須。台帳に送信するシリアル化された protobuf SignedTransaction。添付されたクライアント トランザクションは運用トランザクションである必要があり、送信者はプラットフォーム オペレーターである必要があります。シリアル化された形式を使用すると、すべてのバリデータがシリアル化されたバイトの SHA-256 ダイジェストとして同じトランザクション ID を計算します。

Base64 でエンコードされた文字列。

レスポンスの本文

endpoints.submitOperationalTransaction のレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "transactionDigestHex": string
}
フィールド
transactionDigestHex

string

送信された運用トランザクションを一意に表す識別子。これは、serializedSignedOperationalTransaction の SHA-256 ダイジェストを 16 進数で表したものです。このトランザクション ID は、クライアントがハッシュ ロジック自体を実装しなくてもトランザクションを追跡できるように提供されます。この識別子は、後続の API 呼び出しで直接使用できます（トランザクションの状態をクエリするなど）。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、Authentication Overview をご覧ください。