1. Oracle Transaction Manager for MicroservicesのREST API
  2. タスク
  3. Saga

Sagaトランザクションの完了

put

/admin/v1/lra-coordinator/{id}/close

Sagaトランザクションを完了します。トランザクションを完了するには、トランザクション・イニシエータ・サービスがマイクロサービス対応トランザクション・マネージャをコールし、その後、マイクロサービス対応トランザクション・マネージャが各参加側サービスの完了コールバックURIをコールします。

リクエスト

サポートされているメディア・タイプ
パス・パラメータ
先頭に戻る

レスポンス

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

200レスポンス

OK
本文()
ルート・スキーマ: lra-status
型: string
指定できる値: [ "Active", "Closing", "Closed", "FailedToClose", "Cancelling", "Cancelled", "FailedToCancel" ]

400レスポンス

Invalid Arguments

401レスポンス

Unauthorized

404レスポンス

NotFound

409レスポンス

Conflict
本文()
ルート・スキーマ: lra-status
型: string
指定できる値: [ "Active", "Closing", "Closed", "FailedToClose", "Cancelling", "Cancelled", "FailedToCancel" ]

500レスポンス

InternalServerError
先頭に戻る

例

cURLコマンド

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

暫定予約で受信したレスポンスのLong-Running-ActionおよびOracle-Tmm-Tx-Tokenヘッダーの値を書き留めます。値を直接渡すか、変数に保存できます。Oracle-Tmm-Tx-Tokenヘッダーは、トランザクション・トークンを作成して有効にした場合にのみ、暫定予約のレスポンス本文に表示されます。Transaction Manager for Microservices開発者ガイドのトランザクション・トークンのプロパティを参照してください。

コマンドは1行で入力してください。この例では、読みやすくするために改行を使用しています。値の例は、読みやすくするために...を使用して一部を省いています。ご使用の環境でこのコマンドを実行すると、値全体が表示されます。

curl -X PUT 
     -H "Authorization:Bearer $OTMM_COOKIE"
     -H "Long-Running-Action: [http://otmm-tcs:9000/api/v1/lra-coordinator/57b6...]"
     -H "Oracle-Tmm-Tx-Token: vmrpURFx...qpKmYn2" 
     https://192.0.2.1:8080/admin/v1/lra-coordinator/15cd86ca-e0b7-4778-8cb6-4b78dfb3b981/close

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

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

  • 15cd86ca-e0b7-4778-8cb6-4b78dfb3b981は、SagaトランザクションIDの値の例です。この値は、ご使用の環境のSagaトランザクションのトランザクションIDで置き換えてください。

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

先頭に戻る