移動

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

すべてのXAトランザクションの詳細の取得

get

/admin/v1/xa-transaction

マイクロサービス対応トランザクション・マネージャによって処理され、指定のトランザクション・ステータスと一致するすべてのXAトランザクションの詳細を取得します。問合せパラメータを指定しないと、現在のすべてのXAトランザクションの詳細が取得されます。

リクエスト

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

• application/json

問合せパラメータ

• begin (オプション): integer(int32)
  表示をスキップするオフセットすなわちレコード数を指定します。たとえば、100番目のレコード以降の情報を表示するには、100を入力します。レコード数が多いときは、返される(表示される)レスポンスの数が制限され、{{more }}が{{true }}に設定されて表示するレコードがさらにあることが示されます。{{more }}が{{false }}に設定される場合は、すべてのレコードが表示されています
• status (オプション): string
  トランザクション・ステータス

  指定できる値: [ "Created", "Preparing", "Prepared", "Committing", "Committed", "Rollingback", "Rolledback", "MarkedRollback", "HeuristicallyCompleted" ]

先頭に戻る

レスポンス

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

• application/json

200レスポンス

OK

本文()

ルート・スキーマ: schema

型: array

ソースを表示

• 配列: object xa-transactions

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/xa-transactions"
    }
}

ネストされたスキーマ: xa-transactions

型: object

ソースを表示

• more (オプション): boolean
• transactions (オプション): array transactions

{
    "type":"object",
    "properties":{
        "more":{
            "type":"boolean"
        },
        "transactions":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/xa-transaction"
            }
        }
    }
}

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

型: array

ソースを表示

• 配列: object xa-transaction

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/xa-transaction"
    }
}

ネストされたスキーマ: 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リクエストを送信することによって、すべてのXAトランザクションの詳細を取得する方法を示しています。cURLの詳細は、「cURLの使用」を参照してください

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

curl -X GET 
     -H "Authorization:Bearer $OTMM_COOKIE"
     https://192.0.2.1:8080/admin/v1/xa-transaction

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

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

レスポンス本文の例

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

{
  "more": false,
  "transactions": [
    {
      "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": ""
        }
      ]
    }
  ]
}

先頭に戻る