ユース・ケース

スナップショット機能にはいくつかの使用例がある。 次の例を考えてみましょう。

• 管理者がミドルウェアのアップグレードを計画している。 ミドルウェアへのアップグレードが失敗した場合、管理者はソースディスクを元の状態に戻す必要がある。
• 管理者は以下のステップを完了する：
  1. APIコマンドを 使用して、ミドルウェア情報が存在するソースディスクのスナップショットを開始する。 ソースディスクのスナップショットが作成される。
  2. ミドルウェアをアップグレードします。
  3. アップグレードが失敗した場合、管理者はスナップショットを使用してソースディスクをリストアします。
  4. アップグレードが成功すると、管理者はスナップショットを削除します。

複数のスナップショット操作を開始できます。 しかし、これらの同時スナップショット操作は、異なるディスクセットで発生する。

ユース・ケース

スナップショットをリストアするために、以下のシナリオを考えてみましょう：

• VM スナップショットの一部であるボリュームすべてをリストアする
• 複数の VM リストア操作を実行する
• VM リストア操作が最初に失敗した場合に再試行する
• VM を元のボリューム状態にロールバックする

前提条件

ボリューム・クローン・リクエストの作成を開始する前に、以下の前提条件が満たされていることを確認してください：

• volumes-cloneリクエスト名は、ワークスペースで一意でなければなりません。 ボリュームクローンリクエスト名を再利用する場合は、その名前の既存のボリュームクローンリクエストを削除してから、その名前を再利用します。

• ボリューム・クローン・リクエストに含めるボリュームは、同じストレージ・プール内になければならない。

• volumes-clone要求に含めるボリュームは、 error の状態であってはならず、ボリュームのヘルス状態は ok でなければならない。

• ボリュームクローン要求に含めたいボリュームセットにアクセスするアプリケーションを停止する。

APIおよびCLIコマンドを使用したvolumes-cloneリクエストの作成

Prepare action 、クローンされるボリュームのグループスナップショットを作成するための準備作業が完了します。

前提条件

Prepare action 操作を開始する前に、以下の前提条件が満たされていることを確認する：

• 最低2巻
• 最低1巻は in-use の状態であること
• 固有の volumes-clone 名

Prepare action 操作が進行中の場合、同じボリュームセットに対して別の Prepare action 操作をトリガーすることはできません。 Prepare action 、その後に Start 、 Execute。 既存の Prepare action 操作を使用していない場合は、次の Prepare action 操作を開始する前に、既存の操作をキャンセルする必要があります。

Prepare action 操作を開始するには、以下の API および CLI コマンドを使用する：

• API ： 新しいボリュームクローンリクエストを作成し、Prepareアクションを開始する。
• CLI: ibmcloud pi volume clone create

APIおよびCLIコマンドでは、以下のパラメータに値を指定する必要がある：

• name(必須) ボリュームクローン要求に割り当てられる名前を指定します。 この名前は、既存のすべてのボリュームクローンリクエストの中で一意でなければならない。
• volumeIDs:クローンするボリュームの識別子または名前のリストを指定します。 最低2つのボリュームIDが必要で、少なくとも1つのボリュームが in-use。 volumes-clone要求に含めるボリュームはすべて、同じストレージプール内になければならない。

Prepare action の操作が 100% に進むと、以下の条件によって Prepare のステータスが変化する：

• Prepare action が正常に完了すると、ステータスは prepared に変わる。
• Prepare action が正常に完了しなかった場合、ステータスは failed に変わる。

Prepare action 操作のステータスを確認するには、API または CLI コマンドに volumesCloneID オプションを付ける。

制約事項および考慮事項

• 最低2つのボリュームIDが必要で、そのうち少なくとも1つは in-use。

単一のボリュームをクローンするには、 指定したボリュームのボリュームクローンを作成 API または ibmcloud pi volume clone-async CLI コマンドを使用できます。 単一ボリュームクローンのステータスを確認するには、 指定したクローンタスクIDのボリュームクローン要求のステータスを取得 APIまたはibmcloud pi volume clone-async get CLIコマンドを使用できます。

• in-use 状態のボリュームに対してクローン操作が実行されると、 Power Virtual Server は一貫性のあるグループ・スナップショットを作成し、グループ・スナップショットを使用してクローンされたボリュームのコピーを再作成します。

• クローン操作の進行中は、ディスクサイズなどのソースまたはターゲットディスクの属性を変更することはできません。

• 整合性グループの一部であるボリュームを、既存の整合性グループの一部としてクローンすることはできません。 ボリュームは、volumes-clone開始要求を実行する必要があるか、バックグラウンドでのフラッシュコピーが完了したスナップショット create 操作の一部である後に、整合性グループに属します。

• ボリュームをあるストレージプールから別のストレージプールにクローンすることはできません。

APIとCLIコマンドを使用したボリュームクローンリクエストの開始

ボリューム・コルン・リクエストの初期ステータスは Starting に設定される。

以下のAPIおよびCLIコマンドを使用して、volumes-clone要求を開始する：

• API ： Volumes-CloneリクエストのStartアクションを開始する。
• CLI: ibmcloud pi volume clone start

ボリュームクローン・リクエストの一意な識別子を volume_clones_id パラメータに指定する必要があります。 識別子には、ボリュームクローンIDまたはボリュームクローン名を指定する。

ボリュームクローン要求が開始されると、初期ステータスは Starting に設定される。 グループスナップショットが作成されると、リクエストステータスは Available に変わります。 volumes-cloneリクエストの start 操作は同期的である。 APIコールがクライアントに戻ると、エラーが発生しない限り、volumes-cloneリクエストのステータスは Available。 start 操作中にエラーが発生した場合、volumes-clone 要求のステータスは Failed に変わります。 失敗の理由は、 start 操作のレスポンスとともに返されるエラーで指定される。 準備されたスナップショット・データは、再度同じボリュームのセットを複製できるように削除されます。 ボリュームクローン要求の start 操作をキャンセルすると、ボリュームクローン要求のステータスは Cancelling に変わります。 ボリュームクローンリクエストが Available の状態であれば、ボリュームクローンリクエストをキャンセルできます。

制約事項および考慮事項

ボリューム・クローン・リクエストを開始する前に、以下の制限事項や注意事項を考慮する必要があります：

• 最低2つのボリュームIDが必要で、そのうち少なくとも1つは in-use。

• in-use 状態のボリュームに対してクローン操作が実行されると、 Power Virtual Server は一貫性のあるグループ・スナップショットを作成し、グループ・スナップショットを使用してクローンされたボリュームのコピーを再作成します。

• クローン操作の進行中は、ディスクサイズなどのソースまたはターゲットのディスク属性を変更することはできません。

前提条件

volumes-cloneリクエストは Available の状態でなければならない。

APIとCLIコマンドを使用したボリュームクローン要求の実行

execute 操作を開始すると、初期 percentComplete は 0% となり、ステータスは executing に設定される。

以下のAPIおよびCLIコマンドを使用して、volumes-clone要求を開始する：

• API ： volumes-cloneリクエストの実行アクションを開始する。
• CLI: ibmcloud pi volume clone execute

APIおよびCLIコマンドでは、以下のパラメータに値を指定する必要がある：

• volume-clones-id: (必須) ボリュームクローンリクエストの一意の識別子。 識別子には、ボリュームクローンIDまたはボリュームクローン名を指定する。
• name(必須) 新しいクローン化ボリュームのベース名。 クローン化されたボリューム名の接頭辞は clone- で、接尾辞は -#####-N です。 サフィックスでは、 ##### が5桁の乱数、 N が1から始まるインクリメンタル番号。
• rollbackPrepare(オプション) デフォルト値は False です。 フラグが False に設定されている場合、システムは失敗したロールバッククローン活動を実行するが、準備されたスナップショットはそのまま残される。 フラグが True に設定されると、システムは障害のロールバック・クローン・アクティビティを実行し、準備されたスナップショットを削除します。
• userTags(オプション) 複製ボリュームに添付するユーザータグのリストを指定します。
• targetReplicationEnabled オプション）このフラグを使用して、クローン化ボリュームのレプリケーションを有効または無効にします。 デフォルトでは、このフラグはクローンされるソース・ボリュームのレプリケーション・ステータスを使用します。 False に設定すると、クローンされたボリュームはレプリケーションが有効になりません。 True に設定すると、クローンされたボリュームはレプリケーションが有効になる。

ソースボリュームがレプリケーション用に有効になっておらず、クローン化ボリュームのレプリケーションを有効にする場合は、ソースボリュームが存在するストレージプールがレプリケーション用に有効になっている必要があります。

• targetStorageTier:クローンされたボリュームのストレージ層の名前を指定する。 あるストレージ層から別のストレージ層にボリュームセットをクローンするには、このフィールドを使用する。 クローン化されたボリュームは、ソースボリュームと同じストレージプールに残らなければならない。

制約事項および考慮事項

ボリューム・クローン・リクエストを開始する前に、以下の制限事項や注意事項を考慮する必要があります：

• ボリュームクローンリクエストのステータスが、 completed、 failed、 cancelled のいずれかに変更された時点で、ボリュームクローンリクエストは完了したとみなされる。
• volumes-clone execute リクエストが開始されると、初期ステータスは executing に設定される。
• execute 操作が正常に完了すると、volumes-clone request のステータスは completed に変更される。
• ボリュームの複製処理中にエラーが発生すると、複製プロセスによって作成された成果物はすべて削除されます。 グループスナップショットは available の状態に戻され、 execute 操作を再試行できるようになります。
• executing 、ボリュームクローン要求をキャンセルすることができます。
• ボリュームクローン要求の execute 操作をキャンセルすると、ボリュームクローン要求のステータスは cancelling に変更されます。
• rollbackPrepare オプションを使用することで、失敗した execute 操作の動作を制御することができる。 rollbackPrepare オプションのデフォルト値は false。 デフォルト値では、失敗した execute 操作でクローンアクティビティがロールバックされ、準備されたスナップショットは削除されません。 rollbackPrepare オプションが true に設定されている場合、失敗した execute 操作をクローン活動のロールバックに導き、準備されたスナップショットを削除する。

前提条件

volumes-cloneリクエストは Available の状態でなければならない。

APIおよびCLIコマンドを使用したボリュームクローン要求のキャンセル

cancel 操作を開始すると、初期 percentComplete は 0% となり、ステータスは cancelling に設定される。

volumes-clone要求をキャンセルするには、以下のAPIおよびCLIコマンドを使用する：

• API ： ボリュームクローン要求をキャンセルする
• CLI: ibmcloud pi ボリュームクローンキャンセル

APIおよびCLIコマンドでは、以下のパラメータに値を指定する必要がある：

• volume-clones-id: (必須) ボリュームクローンリクエストの一意の識別子。 識別子には、ボリュームクローンIDまたはボリュームクローン名を指定します
• Force(オプション) デフォルトのステータスは False です。 cancel の操作は、ステータスが prepared または available に設定されている場合にのみ許可される。 ステータスが True に設定されている場合、 NOT completed、 cancelling、 cancelled、 failed に設定されている場合は、 cancel の操作が可能である。

制約事項および考慮事項

ボリューム・クローン・リクエストをキャンセルする前に、以下の制限事項や注意事項を考慮する必要があります：

• ボリュームクローン要求をキャンセルすると、ボリュームクローン要求の初期ステータスは Cancelling に設定されます。 すべてのクリーンアップ作業が正常に完了すると、ステータスは Cancelled。
• ボリュームクローンリクエストが executing の状態であれば、ボリュームクローンリクエストをキャンセルできます。 cancel volume-cloneリクエストでは、 force オプションを True に設定する必要があります。
• volumes-cloneリクエストが Executing 状態にある場合、クローン操作プロセスによって作成されたアーティファクトはすべて削除される。

前提条件

volumes-cloneリクエストは、以下の最終ステータスのいずれかでなければならない： Completed Failed または Cancelled。

APIおよびCLIコマンドを使用したボリュームクローンリクエストの削除

以下のAPIおよびCLIコマンドを使用して、volumes-clone要求を削除する：

• API ： ボリュームクローンリクエストの削除
• CLI: ibmcloud pi volume clone delete

APIおよびCLIコマンドでは、以下のパラメータに値を指定する必要がある：

• volume-clones-id: (必須) ボリュームクローンリクエストの一意の識別子。 識別子には、ボリュームクローンIDまたはボリュームクローン名を指定する。
• Force(オプション) ボリューム・クローン・リクエストを強制的にキャンセルする。 cancel の操作は、ステータスが prepared または available に設定されている場合にのみ許可される。 ステータスが True に設定されている場合、 NOT completed、 cancelling、 cancelled、 failed に設定されている場合は、 cancel の操作が可能である。

制約事項および考慮事項

volumes-clone要求が削除に必要な最終ステータスのいずれでもない場合、要求をキャンセルし、残りのクリーンアップを行い、ステータスを Cancelled に移行することができます。 volumes-clone要求が Cancelled ステータスの場合、要求を削除することができます。

前提条件

なし。

APIとCLIコマンドを使用して、ボリュームクローン要求のステータスを取得する

• API ： 指定されたクローンタスクIDのボリュームクローンリクエストのステータスを取得する
• CLI: ibmcloud pi volume clone get

volume-clones-id。 この値は、ボリュームクローン・リクエストの一意な識別子である。 識別子には、ボリュームクローンIDまたはボリュームクローン名を指定する。

制約事項および考慮事項

なし。

前提条件

なし。

APIとCLIコマンドを使用したボリュームクローン要求のリスト取得

• API ： クラウドインスタンスのボリュームクローンリクエストのリストを取得する
• CLI: ibmcloud pi ボリュームクローンリスト

filter パラメータには、以下の一覧からいずれかの値を指定する：

• prepare- ステータス値（準備中、準備完了）を含む
• start- ステータス値（開始、使用可能）を含む
• execute- ステータス値（実行中、ロールバック可能）を含む
• cancel- ステータス値を含む（キャンセル）
• completed- ステータス値（完了）を含む
• failed- ステータス値（失敗）を含む
• cancelled- ステータス値（キャンセル）を含む
• finalized- 含まれるステータス値（完了、失敗、キャンセル）

制約事項および考慮事項

ボリュームクローンリクエストのリストを取得する前に、以下の制限事項や考慮事項を考慮する必要があります：

• ソース・ボリュームまたは複製されたボリュームに関する詳細情報は提供されません。

• リストは、 filter パラメータを使って制限することができる。 フィルターは'filter'パラメーターのステータスに基づく。