CreateGroupSnapshotを使用すると、ボリュームのグループのポイントインタイム コピーを作成できます。
このSnapshotをあとでバックアップまたはロールバックとして使用すると、Snapshotを作成した時点でのボリューム グループのデータの整合性を確保できます。
このメソッドの入力パラメータは次のとおりです。
名前 | 説明 | タイプ | デフォルト値 | 必須 |
---|---|---|---|---|
attributes | JSONオブジェクト形式の名前と値のペアのリスト。 | JSONオブジェクト | なし | × |
enableRemoteReplication | Snapshotをリモート ストレージにレプリケートするかどうかを指定します。有効な値は次のとおりです。
|
ブーリアン | false | × |
name | グループSnapshotの名前。名前を入力しない場合、グループSnapshotの作成日時が使用されます。最大文字数は255文字です。 | 文字列 | なし | × |
retention | Snapshotが保持される時間。値を指定しない場合、Snapshotは無期限に保持されます。HH:mm:ss形式で入力します。 | 文字列 | なし | × |
snapMirrorLabel | SnapMirrorエンドポイントでのSnapshot保持ポリシーを指定するためにSnapMirrorソフトウェアで使用されるラベル。 | 文字列 | なし | × |
volumes | コピー元のボリューム イメージの一意のID。 | volumeIDの配列 | なし | ○ |
このメソッドの戻り値は次のとおりです。
名前 | 説明 | タイプ |
---|---|---|
members | グループの各メンバーのchecksum、volumeID、snapshotIDのリスト。有効な値は次のとおりです。
|
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 } ] } }