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 グループの各メンバーのchecksumvolumeIDsnapshotIDのリスト。有効な値は次のとおりです。
  • 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
      }
    ]
  }
}

新規導入バージョン

9.6