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 をご覧ください。

IAM 権限

endpoint リソースに対する次の IAM 権限が必要です。

  • universalledger.endpoints.submit

詳細については、IAM のドキュメントをご覧ください。