CreatGroupSnapshot
您可以使用「Create GroupSnapshot」建立一組磁碟區的時間點複本。
您可以稍後使用此快照做為備份或復原、以確保磁碟區群組中的資料在您建立快照的時間點保持一致。
叢集完整度
|
|
如果叢集完整度處於階段1、2或3、您可以建立快照。叢集完整度達到階段4或5時、您無法建立快照。 |
參數
此方法具有下列輸入參數:
| 名稱 | 說明 | 類型 | 預設值 | 必要 |
|---|---|---|---|---|
屬性 |
Json物件格式的名稱-值配對清單。 |
Json物件 |
無 |
否 |
「enableRemoteReplication」 |
指定是否將快照複寫至遠端儲存設備。可能值:
|
布林值 |
錯 |
否 |
「EnureSerialCreation」 |
指定如果正在進行先前的快照複寫、則不應建立快照。可能的值包括:
|
布林值 |
「假」 |
否 |
「過期時間」 |
指定快照可移除的時間。無法與"REtion"一起使用。如果未指定「過期時間」或「快照」、則快照不會過期。時間格式為ISO 8601日期字串、適用於基於時間的到期日、否則將不會過期。如果值為「null」、則會永久保留快照。如果值為「fifo」、則快照會以先進先出(FIFO)為基準、相對於磁碟區上的其他FIFO快照來保留。如果沒有可用的FIFO空間、API將會失敗。 |
ISO 8601日期字串 |
無 |
否 |
名稱 |
群組快照的名稱。如果未輸入名稱、則會使用拍攝群組快照的日期和時間。名稱長度上限為255個字元。 |
字串 |
無 |
否 |
《狀態》 |
此參數與「過期時間」參數相同、但時間格式為hh:mms如果既未指定「過期時間」、也未指定「保留時間」、則快照不會過期。 |
字串 |
無 |
否 |
「napMirrorLabel」 |
SnapMirror軟體用來指定SnapMirror端點上的快照保留原則的標籤。 |
字串 |
無 |
否 |
《Volume》(Volume) |
要複製之Volume映像的唯一ID。 |
Volume ID陣列 |
無 |
是的 |
傳回值
此方法具有下列傳回值:
名稱 |
說明 |
類型 |
成員 |
群組每個成員的Checksum、volumeID和snapshotID清單。有效值:
|
Json物件陣列 |
群組SnapshotID |
新群組快照的唯一ID。 |
群組Snapshot ID |
群組Snapshot |
包含新建立之群組快照相關資訊的物件。 |
申請範例
此方法的要求類似於下列範例:
{
"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