2.18　リソースのロック

REST APIでは、セッション単位にロックを制御します。ロックは、セッションを生成したユーザに割り当てられているリソースグループのリソース全体が対象です。自分に割り当てられているリソースグループが、ほかのユーザによってロック中の場合は、ロックを取得できません。

リソースをロックするリクエストで使用したセッションだけが、ロック中のリソースに対する構成変更のリクエストを実行できます。1つのユーザアカウントが複数のセッションを生成した場合、同じユーザアカウントによって生成されたセッションでも、ロック時に使用したのとは異なるセッションを指定したときは、構成変更のリクエストを実行できません。

1つのユーザアカウントで複数のセッションを使用している場合は、そのうち1つのセッションだけがリソースをロックできます。

操作が終了してロックが不要になったら、リソースグループをアンロックするAPIを実行します。ロック時に使用したセッションが破棄されると、同時にリソースグループがアンロックされます。セッションタイムアウトでセッションが破棄される場合も、同時にアンロックされます。

ヒント

• 非同期処理のAPIが実行中でも、セッションタイムアウトは発生します。非同期処理のAPIの実行中、ロックを継続したい場合は、定期的にジョブの状態をチェックするリクエストを発行するなどして、セッションがタイムアウトしないようにしてください。
• REST APIクライアントから意図せずにロックが継続されている場合や、トークンを紛失した場合など、強制的にロックを解除したいときは、セッションタイムアウトになるまで待つか、Administrator ユーザグループ（ビルトイングループ）に属するユーザ（VSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデルまたはVSP F1500の場合）、またはmaintenanceユーザ（Virtual Storage PlatformまたはUnified Storage VMの場合）でセッションを強制的に破棄してください。
• ロック中に、ロックしているユーザの情報（ロールやリソースグループなど）が変更された場合は、ロックが解除されてから操作に反映されます。

ロック機能を使用してAPIを実行する操作の流れ

リソースグループをロックしてAPIを実行する場合の操作の流れを次に示します。

ロック機能を使用してAPIを実行する操作の流れ（リモートコピーの場合）

ローカルストレージシステムとリモートストレージシステムの両方のリソースをロックする場合の操作の流れについて次に示します。

ヒント

リモートコピーペア作成を実行すると、ストレージシステムでのペア作成の初期コピー処理に長時間掛かることがあります。その場合、ペア生成が完了するまでリソースをロックしたままでいると、長時間ほかのクライアントがそのリソースグループのリソースを使用できなくなります。ストレージシステムでペア作成の要求が受け付けられたあとは、REST APIでロックをかける必要はないため、リモートペア作成時には、ジョブの状態がStorageAcceptedに遷移した時点でロックを解除することをお勧めします。