CreateGroupSnapshot

CreateGroupSnapshotを使用すると、ボリュームのグループのポイントインタイムコピーを作成できます。

このSnapshotをあとでバックアップまたはロールバックとして使用すると、Snapshotを作成した時点でのボリュームグループのデータの整合性を確保できます。

CLUSTER_FULLNESS

注:クラスタフルのステージが1、2、または3の間はSnapshotを作成できます。ステージが4または5に達すると、Snapshotを作成できなくなります。

パラメータ

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

名前	説明	タイプ	デフォルト値	必須
attributes	JSONオブジェクト形式の名前と値のペアのリスト。	JSONオブジェクト	なし	×
enableRemoteReplication	Snapshotをリモートストレージにレプリケートするかどうかを指定します。有効な値は次のとおりです。 true：Snapshotがリモートストレージにレプリケートされます。 false：Snapshotはリモートストレージにレプリケートされません。	ブーリアン	false	×
name	グループSnapshotの名前。名前を入力しない場合、グループSnapshotの作成日時が使用されます。最大文字数は255文字です。	文字列	なし	×
retention	Snapshotが保持される時間。値を指定しない場合、Snapshotは無期限に保持されます。HH:mm:ss形式で入力します。	文字列	なし	×
snapMirrorLabel	SnapMirrorエンドポイントでのSnapshot保持ポリシーを指定するためにSnapMirrorソフトウェアで使用されるラベル。	文字列	なし	×
volumes	コピー元のボリュームイメージの一意のID。	volumeIDの配列	なし	○

戻り値

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

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

要求例

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

{
   "method": "CreateGroupSnapshot",
   "params": {
      "volumes": [1,2]
   },
   "id": 1
}

応答例

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

{
  "id": 1,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-04T22:43:29Z",
      "groupSnapshotID": 45,
      "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3323,
          "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
          "status": "done",
          "totalSize": 5000658944,
          "virtualVolumeID": null,
          "volumeID": 1
        },
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3324,
          "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
          "status": "done",
          "totalSize": 6001000448,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-04T22:43:29Z",
      "status": "done"
    },
    "groupSnapshotID": 45,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 3323,
        "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
        "volumeID": 1
      },
      {
        "checksum": "0x0",
        "snapshotID": 3324,
        "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
        "volumeID": 2
      }
    ]
  }
}