Oracle Transaction Manager for MicroservicesのREST API

XAトランザクションのロールバック

delete

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

予期しない理由から参加側サービスによってコミットもロールバックも行われていない保留中トランザクションがある場合は、このリクエストを使用して、特定のトランザクションIDのトランザクションを強制的にロールバックします。マイクロサービス対応トランザクション・マネージャは、指定したトランザクションIDに関係するすべての参加側に同期的にロールバック・コールを送信します。トランザクションをロールバックできるのは、トランザクション・ステータスがCreated、PreparingまたはRollingbackの場合です。

リクエスト

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

application/json

パス・パラメータ

id(必須): string

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

先頭に戻る

レスポンス

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

application/json

200レスポンス

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

型: object

ソースを表示

branches: array branches
status: string

指定できる値: [ "TX_OK", "TX_ROLLBACK", "TX_MIXED", "TX_HAZARD", "TX_PROTOCOL_ERROR", "TX_ERROR", "TX_FAIL", "TX_COMMITTED" ]
txid: string

{
    "type":"object",
    "properties":{
        "txid":{
            "type":"string"
        },
        "status":{
            "$ref":"#/definitions/xa-return-code"
        },
        "branches":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "branchId":{
                        "type":"string"
                    },
                    "url":{
                        "type":"string"
                    },
                    "status":{
                        "$ref":"#/definitions/xa-participant-status"
                    },
                    "returnCode":{
                        "$ref":"#/definitions/branch-return-code"
                    }
                }
            }
        }
    }
}

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

型: array

ソースを表示

配列: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "branchId":{
                "type":"string"
            },
            "url":{
                "type":"string"
            },
            "status":{
                "$ref":"#/definitions/xa-participant-status"
            },
            "returnCode":{
                "$ref":"#/definitions/branch-return-code"
            }
        }
    }
}

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

型: object

ソースを表示

branchId: string
returnCode: string

指定できる値: [ "XA_RBROLLBACK", "XA_RBCOMMFAIL", "XA_RBDEADLOCK", "XA_RBINTEGRITY", "XA_RBOTHER", "XA_RBPROTO", "XA_RBTIMEOUT", "XA_RBTRANSIENT", "XA_NOMIGRATE", "XA_HEURHAZ", "XA_HEURCOM", "XA_HEURRB", "XA_HEURMIX", "XA_RETRY", "XA_RDONLY", "XA_OK", "XAER_ASYNC", "XAER_RMERR", "XAER_NOTA", "XAER_INVAL", "XAER_PROTO", "XAER_RMFAIL" ]
status: string

指定できる値: [ "Enlisted", "Prepared", "Committed", "Rolledback", "HeuristicallyCompleted", "HeuristicallyRolledback" ]
url: string

{
    "type":"object",
    "properties":{
        "branchId":{
            "type":"string"
        },
        "url":{
            "type":"string"
        },
        "status":{
            "$ref":"#/definitions/xa-participant-status"
        },
        "returnCode":{
            "$ref":"#/definitions/branch-return-code"
        }
    }
}

400レスポンス

Invalid Arguments

401レスポンス

Unauthorized

404レスポンス

Not Found

412レスポンス

Precondition Failed

先頭に戻る

例

cURLコマンド

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

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

curl -X PUT 
     -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で置き換えてください。

このリクエストに対してレスポンスは返されません。

先頭に戻る