CreateGroupSnapshot を作成します
変更を提案
PDF
CreateGroupSnapshot を使用すると ' ボリュームのグループのポイント・イン・タイム・コピーを作成できます
この Snapshot をあとでバックアップまたはロールバックとして使用すると、 Snapshot を作成した時点でのボリュームグループのデータの整合性を確保できます。
-
cluster_Full*
|
Snapshot を作成できるのは、クラスタフルが「ステージ 1 」、「ステージ 2 」、または「ステージ 3 」の場合です。ステージが 4 または 5 に達すると、 Snapshot を作成できなくなります。 |
パラメータ
このメソッドの入力パラメータは次のとおりです。
| 名前 | 説明 | を入力します | デフォルト値 | 必須 |
|---|---|---|---|---|
「 attributes 」 |
JSON オブジェクト形式の名前と値のペアのリスト。 |
JSON オブジェクト |
なし |
いいえ |
enableRemoteReplication |
Snapshot をリモートストレージにレプリケートするかどうかを指定します。有効な値は次のとおり
|
ブール値 |
いいえ |
いいえ |
「 enseireSerialCreation 」 |
以前の Snapshot レプリケーションが実行中の場合に Snapshot を作成しないように指定します。有効な値は次のとおりです。
|
ブール値 |
「偽」 |
いいえ |
'expirationTime' |
Snapshot を削除するまでの時間を指定します。「保持」と一緒に使用することはできません。'expirationTime' または '`retention' が指定されていない場合 ' スナップショットは期限切れになりません時刻の形式は、時間ベースの期限を表す ISO 8601 形式の日付文字列であり、それ以外の場合は期限切れになりません。値が null の場合 ' スナップショットは永続的に保持されますFIFO の値を設定すると、ボリューム上の他の FIFO スナップショットと比較して、 FIFO （ First-In First-Out ）ベースでスナップショットが保持されます。使用可能な FIFO 領域がない場合、 API は失敗します。 |
ISO 8601 形式の日付文字列 |
なし |
いいえ |
「 name 」 |
グループ Snapshot の名前。名前を入力しない場合、グループ Snapshot の作成日時が使用されます。最大文字数は 255 文字です。 |
文字列 |
なし |
いいえ |
「延長」 |
このパラメータは 'expirationTime' パラメータと同じですが ' 時刻の形式は HH:mm:ss です'expirationTime' も '`retention' も指定しない場合 ' スナップショットは期限切れになりません |
文字列 |
なし |
いいえ |
「 MirrorLabel 」を参照してください |
SnapMirror エンドポイントでの Snapshot 保持ポリシーを指定するために SnapMirror ソフトウェアで使用されるラベル。 |
文字列 |
なし |
いいえ |
「ボリューム」 |
コピー元のボリュームイメージの一意の ID 。 |
volumeID の配列 |
なし |
はい。 |
戻り値
このメソッドの戻り値は次のとおりです。
名前 |
説明 |
を入力します |
メンバー |
グループの各メンバーのチェックサム、ボリューム ID 、 Snapshot ID のリスト。有効な値：
|
JSON オブジェクトの配列 |
groupSnapshotID |
新しいグループ Snapshot の一意の ID 。 |
グループ Snapshot ID |
groupSnapshot |
作成されたグループ 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