移動

• リクエスト
• レスポンス
• 例

アトミック・トランザクションの問合せ

get

/restproxy/api/v2/atomicTransactions/{globalTransactionId}

アトミック・トランザクションを問い合せます。このエンドポイントは、グローバル(アトミック)・トランザクションIDを指定して、アトミック・トランザクションのステータスを問い合せるために使用されます。

リクエスト

サポートされるメディア・タイプ

• application/json

パス・パラメータ

• globalTransactionId(必須): string
  グローバル・トランザクションID

問合せパラメータ

• role: string
  使用するHyperledger Fabric登録

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

200レスポンス

操作の成功

本文()

ルート・スキーマ: schema

型: object

ソースの表示

• error: string
• result: object atomicTransactionResults
• returnCode(必須): string
  許容値: [ "Success", "Failure" ]

{
    "type":"object",
    "required":[
        "returnCode"
    ],
    "properties":{
        "returnCode":{
            "$ref":"#/definitions/returnCode"
        },
        "error":{
            "type":"string"
        },
        "result":{
            "$ref":"#/definitions/atomicTransactionResults"
        }
    }
}

ネストしたスキーマ: atomicTransactionResults

型: object

ソースの表示

• globalStatus: string
  アトミック・トランザクションの現在のステータス
• globalTxid: string
  グローバル・トランザクションID
• lrc: object atomicTransactionLRCResults
• transactions: array transactions
  処理された個々のトランザクションの詳細
• txStartTime: string
  トランザクションの実行開始時間

{
    "type":"object",
    "properties":{
        "transactions":{
            "description":"Details of individual transactions processed",
            "type":"array",
            "items":{
                "$ref":"#/definitions/atomicTransactionIndividualResults"
            }
        },
        "lrc":{
            "$ref":"#/definitions/atomicTransactionLRCResults"
        },
        "globalStatus":{
            "description":"Current Status of the atomic transaction",
            "type":"string"
        },
        "globalTxid":{
            "description":"Global Transaction ID",
            "type":"string"
        },
        "txStartTime":{
            "description":"Transaction execution start time",
            "type":"string"
        }
    }
}

ネストしたスキーマ: atomicTransactionLRCResults

型: object

ソースの表示

• ethResp: object atomicTransactionEthResponse
• txStatus: string
  LRCトランザクションの現在のステータス

{
    "type":"object",
    "properties":{
        "txStatus":{
            "description":"Current status of the LRC transaction",
            "type":"string"
        },
        "ethResp":{
            "$ref":"#/definitions/atomicTransactionEthResponse"
        }
    }
}

ネストしたスキーマ: transactions

型: array

処理された個々のトランザクションの詳細

ソースの表示

• 配列: object atomicTransactionIndividualResults

{
    "description":"Details of individual transactions processed",
    "type":"array",
    "items":{
        "$ref":"#/definitions/atomicTransactionIndividualResults"
    }
}

ネストしたスキーマ: atomicTransactionEthResponse

型: object

ソースの表示

• block: integer
  コミットされたトランザクションのブロック番号
• error: string
  失敗の場合のエラー・メッセージ
• txHex: string
  実行されたトランザクションを表す16進文字列

{
    "type":"object",
    "properties":{
        "block":{
            "description":"Block number of the committed transaction",
            "type":"integer"
        },
        "txHex":{
            "description":"Hex string representing the transaction executed",
            "type":"string"
        },
        "error":{
            "description":"Error message in case of failures",
            "type":"string"
        }
    }
}

ネストしたスキーマ: atomicTransactionIndividualResults

型: object

ソースの表示

• chaincode: string
  呼び出されたチェーンコードのID
• channel: string
  トランザクションが呼び出されたチャネルのID
• commit: object commit
  トランザクションのコミット・フェーズの詳細
• prepare: object prepare
  トランザクションの準備フェーズの詳細
• rollback: object rollback
  トランザクションのロールバック・フェーズの詳細
• txstatus: string
  個々のトランザクションの現在のステータス

{
    "type":"object",
    "properties":{
        "channel":{
            "description":"ID of the channel on which the transaction was invoked",
            "type":"string"
        },
        "chaincode":{
            "description":"ID of the chaincode invoked",
            "type":"string"
        },
        "txstatus":{
            "description":"Current status of the individual transaction",
            "type":"string"
        },
        "prepare":{
            "description":"Details on the prepare phase of the transaction",
            "type":"object",
            "properties":{
                "txid":{
                    "description":"Transaction ID for the prepare phase",
                    "type":"string"
                },
                "error":{
                    "description":"Error message in case the transaction fails",
                    "type":"string"
                }
            }
        },
        "commit":{
            "description":"Details on the commit phase of the transaction",
            "type":"object",
            "properties":{
                "txid":{
                    "description":"Transaction ID for the commit phase",
                    "type":"string"
                },
                "error":{
                    "description":"Error message in case the transaction fails",
                    "type":"string"
                }
            }
        },
        "rollback":{
            "description":"Details on the rollback phase of the transaction",
            "type":"object",
            "properties":{
                "txid":{
                    "description":"Transaction ID for the rollback phase",
                    "type":"string"
                },
                "error":{
                    "description":"Error message in case the transaction fails",
                    "type":"string"
                }
            }
        }
    }
}

ネストしたスキーマ: commit

型: object

トランザクションのコミット・フェーズの詳細

ソースの表示

• error: string
  トランザクションが失敗した場合のエラー・メッセージ
• txid: string
  コミット・フェーズのトランザクションID

{
    "description":"Details on the commit phase of the transaction",
    "type":"object",
    "properties":{
        "txid":{
            "description":"Transaction ID for the commit phase",
            "type":"string"
        },
        "error":{
            "description":"Error message in case the transaction fails",
            "type":"string"
        }
    }
}

ネストしたスキーマ: prepare

型: object

トランザクションの準備フェーズの詳細

ソースの表示

• error: string
  トランザクションが失敗した場合のエラー・メッセージ
• txid: string
  準備フェーズのトランザクションID

{
    "description":"Details on the prepare phase of the transaction",
    "type":"object",
    "properties":{
        "txid":{
            "description":"Transaction ID for the prepare phase",
            "type":"string"
        },
        "error":{
            "description":"Error message in case the transaction fails",
            "type":"string"
        }
    }
}

ネストしたスキーマ: rollback

型: object

トランザクションのロールバック・フェーズの詳細

ソースの表示

• error: string
  トランザクションが失敗した場合のエラー・メッセージ
• txid: string
  ロールバック・フェーズのトランザクションID

{
    "description":"Details on the rollback phase of the transaction",
    "type":"object",
    "properties":{
        "txid":{
            "description":"Transaction ID for the rollback phase",
            "type":"string"
        },
        "error":{
            "description":"Error message in case the transaction fails",
            "type":"string"
        }
    }
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止されています

404レスポンス

無効なパラメータ

500レスポンス

サービス使用不可

先頭に戻る

例

このエンドポイントは、グローバル(アトミック)・トランザクションIDを指定して、アトミック・トランザクションのステータスを問い合せるために使用されます。

次の例は、cURLを使用してRESTリソースに対するGETリクエストを送信し、アトミック・トランザクションを問い合せる方法を示しています。

curl -v -u <username>:<password> -X GET \
  "https://<rest proxy of your blockchain instance>/api/v2/atomicTransactions/<global_transaction_id>" \
  -H "accept: application/json"

たとえば、

curl -v -u <username>:<password> -X GET \
  "https://myvm.oracle.com:10001/restproxy/api/v2/atomicTransactions/21438a99-9fd7-4f96-b0bf-259910a26006" \
  -H "accept: application/json"

レスポンス本文の例

次の例に、成功したアトミック・トランザクションに対するJSON形式のレスポンス本文の内容を示します:

{
  "returnCode": "Success",
  "error": "",
  "result": {
    "transactions": [
      {
        "channel": "goods",
        "chaincode": "obcs-marbles",
        "txstatus": "Committed",
        "prepare": {
          "txid": "bb248ef3f948cb107417c3f66ea144910644dee8086a370d44687fd9fe262233"
        },
        "commit": {
          "txid": "21068846ef85942f9df1ccfd27dcb95d509146c5a0d10c6366642215badcb3b4"
        },
        "rollback": {}
      },
      {
        "channel": "wallet",
        "chaincode": "obcs-example02",
        "txstatus": "Committed",
        "prepare": {
          "txid": "08d03d7170e7f696c79da0aa60142bbfdc08b3d92cee0d9423983dd19caf809c"
        },
        "commit": {
          "txid": "ef9d8a824631f9e671162b81c7d1617080746ef3897b029cfbef1cfd1594d0ab"
        },
        "rollback": {}
      }
    ],
    "globalStatus": "Success",
    "globalTxid": "21438a99-9fd7-4f96-b0bf-259910a26006",
    "txStartTime": "2022-08-15T16:16:19.2180799642"
  }
}

この場合、globalStatusに返される値はSuccessで、アトミック・トランザクションを構成するすべてのトランザクションが正常にコミットされたことを示します。

先頭に戻る