RollbackToGroupSnapshot

RollbackToGroupSnapshotを使用すると、Snapshotグループ内のすべてのボリュームを、それぞれのボリュームのSnapshotにロールバックできます。

グループSnapshotにロールバックすると、グループSnapshot内に各ボリュームの一時Snapshotが作成されます。
注: Snapshotを作成できるのは、クラスタ フルが「ステージ1」、「ステージ2」、または「ステージ3」の場合です。クラスタ フルが「ステージ4」または「ステージ5」の場合、Snapshotは作成されません。

パラメータ

このメソッドの入力パラメータは次のとおりです。

名前 説明 タイプ デフォルト値 必須
groupSnapshotID グループSnapshotの一意のID。 整数 なし
attributes JSONオブジェクト形式の名前と値のペアのリスト。 JSONオブジェクト なし ×
name saveCurrentStatetrueの場合に作成される、ボリュームの現在の状態のグループSnapshotの名前。名前を指定しない場合、Snapshot(グループおよび個々のボリューム)の名前には、ロールバックが発生した時間のタイムスタンプが設定されます。 文字列 なし ×
saveCurrentState 以前のアクティブ ボリューム イメージを保存するかどうかを指定します。有効な値は次のとおりです。
  • true:以前のアクティブ ボリューム イメージは保持されます。
  • false:以前のアクティブ ボリューム イメージは削除されます。
ブーリアン false ×

戻り値

このメソッドの戻り値は次のとおりです。

名前 説明 タイプ
members グループSnapshotのメンバーのボリュームIDとSnapshot IDを含む配列。値は次のとおりです。
  • checksum:保存されたSnapshotのデータを表す短い文字列。このチェックサムを使用して、あとで他のSnapshotと比較してデータ内のエラーを検出できます (文字列)。
  • snapshotID:新しいSnapshotの作成元Snapshotの一意のID。Snapshot IDは、指定したボリュームのSnapshotのIDである必要があります (整数)。
  • volumeID:Snapshotのソース ボリュームのID (整数)。
JSONオブジェクトの配列
groupSnapshotID

saveCurrentStatefalseに設定されている場合、この値はnullになります。

saveCurrentStatetrueに設定されている場合、新しく作成されたグループSnapshotの一意のIDです。

整数
groupSnapshot

saveCurrentStatefalseに設定されている場合、この値はnullになります。

saveCurrentStatetrueに設定されている場合、RollbackToGroupSnapshotでロールバックされたグループSnapshotの情報を含むオブジェクトです。

groupSnapshot

要求例

このメソッドの要求例を次に示します。

{
  "id": 438,
  "method": "RollbackToGroupSnapshot",
  "params": {
    "groupSnapshotID": 1,
    "name": "grpsnap1",
    "saveCurrentState": true
  }
}

応答例

このメソッドの応答例を次に示します。

{
  "id": 438,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-06T17:27:17Z",
      "groupSnapshotID": 1,
      "groupSnapshotUUID": "468fe181-0002-4b1d-ae7f-8b2a5c171eee",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-06T17:27:17Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 1,
          "groupSnapshotUUID": "468fe181-0002-4b1d-ae7f-8b2a5c171eee",
          "name": "2016-04-06T17:27:17Z",
          "snapshotID": 4,
          "snapshotUUID": "03563c5e-51c4-4e3b-a256-a4d0e6b7959d",
          "status": "done",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-06T17:27:17Z",
      "status": "done"
    },
    "groupSnapshotID": 3,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 2,
        "snapshotUUID": "719b162c-e170-4d80-b4c7-1282ed88f4e1",
        "volumeID": 2
      }
    ]
  }
}

新規導入バージョン

9.6