移動

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

1つのXAトランザクションの詳細の取得

get

/admin/v1/xa-transaction/{id}

指定されたXAトランザクションIDの詳細を取得します。

リクエスト

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

• application/json

パス・パラメータ

• id: string
  XAトランザクションのグローバル・トランザクションID (GTRID)。これはトランザクションの追跡に使用できる一意のIDです。

先頭に戻る

レスポンス

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

• application/json

200レスポンス

OK

本文()

ルート・スキーマ: xa-transaction

型: object

ソースを表示

• begin: integer(int64)
  XAトランザクション開始タイムスタンプ
• branches (オプション): array branches
• end: integer(int64)
  XAトランザクション終了タイムスタンプ
• gtrid: string
  XAトランザクションのグローバル・トランザクションID (GTRID)
• hostname: string
  XAトランザクションが初期化されるTMMコーディネータ・インスタンスID
• status: string
  指定できる値: [ "Created", "Preparing", "Prepared", "Committing", "Committed", "Rollingback", "Rolledback", "MarkedRollback", "HeuristicallyCompleted" ]
• timeout: integer(int32)
  XAトランザクション・タイムアウト値(ミリ秒)
• userId: string
  XAトランザクションを開始したユーザーのID

{
    "type":"object",
    "required":[
        "gtrid",
        "userId",
        "hostname",
        "begin",
        "end",
        "timeout",
        "status"
    ],
    "properties":{
        "gtrid":{
            "type":"string",
            "description":"Global transaction ID (GTRID) of the XA transaction"
        },
        "userId":{
            "type":"string",
            "description":"Id of the user who initiated the XA transaction"
        },
        "hostname":{
            "type":"string",
            "description":"TMM coordinator instance id where the XA transaction gets initialized"
        },
        "begin":{
            "type":"integer",
            "format":"int64",
            "description":"XA transaction begin timestamp"
        },
        "end":{
            "type":"integer",
            "format":"int64",
            "description":"XA transaction end timestamp"
        },
        "timeout":{
            "type":"integer",
            "format":"int32",
            "description":"XA transaction timeout value in milli seconds"
        },
        "status":{
            "$ref":"#/definitions/xa-status"
        },
        "branches":{
            "type":"array",
            "items":{
                "type":"object",
                "description":"XA transaction branches",
                "required":[
                    "branchId",
                    "url",
                    "status"
                ],
                "properties":{
                    "branchId":{
                        "type":"string",
                        "description":"XA transaction branch identifier"
                    },
                    "url":{
                        "type":"string",
                        "description":"XA transaction branch call back url"
                    },
                    "status":{
                        "$ref":"#/definitions/xa-participant-status"
                    }
                }
            }
        }
    }
}

ネストされたスキーマ: branches

型: array

ソースを表示

• 配列: object items
  XAトランザクション・ブランチ

{
    "type":"array",
    "items":{
        "type":"object",
        "description":"XA transaction branches",
        "required":[
            "branchId",
            "url",
            "status"
        ],
        "properties":{
            "branchId":{
                "type":"string",
                "description":"XA transaction branch identifier"
            },
            "url":{
                "type":"string",
                "description":"XA transaction branch call back url"
            },
            "status":{
                "$ref":"#/definitions/xa-participant-status"
            }
        }
    }
}

ネストされたスキーマ: items

型: object

XAトランザクション・ブランチ

ソースを表示

• branchId: string
  XAトランザクション・ブランチ識別子
• status: string
  指定できる値: [ "Enlisted", "Prepared", "Committed", "Rolledback", "HeuristicallyCompleted", "HeuristicallyRolledback" ]
• url: string
  XAトランザクション・ブランチ・コールバックURL

{
    "type":"object",
    "description":"XA transaction branches",
    "required":[
        "branchId",
        "url",
        "status"
    ],
    "properties":{
        "branchId":{
            "type":"string",
            "description":"XA transaction branch identifier"
        },
        "url":{
            "type":"string",
            "description":"XA transaction branch call back url"
        },
        "status":{
            "$ref":"#/definitions/xa-participant-status"
        }
    }
}

400レスポンス

Invalid Arguments

401レスポンス

Unauthorized

先頭に戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースにGETリクエストを送信することによって、1つのXAトランザクションの詳細を表示する方法を示しています。cURLの詳細は、「cURLの使用」を参照してください

コマンドは1行で入力してください。この例では、読みやすくするために改行を使用しています。

curl -X GET 
     -H "Authorization:Bearer $OTMM_COOKIE"
     https://192.0.2.1:8080/admin/v1/xa-transaction/e6808684-5d8c-4ad0-90d2-345a225d0f02

• OTMM_COOKIEは、前に認証cookieを格納した変数の名前です。認証cookieの取得および変数への格納の詳細は、認証を参照してください。

• 192.0.2.1:8080は、RESTエンドポイントURLの例です。この値をRESTエンドポイントURLに変更して、ご使用の環境のIstioイングレス・ゲートウェイにアクセスします。ご使用のサイトのRESTエンドポイントURLを確認する方法の詳細は、リクエストの送信を参照してください。

• e6808684-5d8c-4ad0-90d2-345a225d0f02は、グローバル・トランザクションID (GTRID)の値の例ですこの値は、ご使用の環境のXAトランザクションのGTRIDで置き換えてください。

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。値の例は、読みやすくするために...を使用して一部を省いています。ご使用の環境でレスポンスを確認すると、値全体が表示されます。

{
  "begin": 1656909341649,
  "encryptedEntry": "Rw/egNz7...",
  "end": 0,
  "gtrid": "e6808684-5d8c-4ad0-90d2-345a225d0f02",
  "hostname": "otmm-tcs-6499...",
  "keyVersion": "1",
  "nonce": "HUnUlVyEhiFjJSU/",
  "status": "Created",
  "thumbprint": "Bearer eyJhb....",
  "timeout": 600000,
  "userId": "43225c1...",
  "branches": [
    {
      "branchId": "otmm-tcs-0-0001",
      "url": "http://dept1:9091/accounts",
      "resourceManagerId": "DEP1-NODE-1D98-479...",
      "status": "Committed",
      "returnCode": "XA_OK",
      "llrBranch": false,
      "encryptedEntry": "",
      "nonce": "",
      "keyVersion": "",
      "thumbprint": ""
    }
  ]
}

先頭に戻る