Skip to main content
12.5
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

CreateGroupSnapshot を作成します

共同作成者
PDF

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

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

  • cluster_Full*

メモ Snapshot を作成できるのは、クラスタフルが「ステージ 1 」、「ステージ 2 」、または「ステージ 3 」の場合です。ステージが 4 または 5 に達すると、 Snapshot を作成できなくなります。

パラメータ

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

名前 製品説明 タイプ デフォルト値 必須

attributes

JSON オブジェクト形式の名前と値のペアのリスト。

JSON（オブジェクト）

なし

いいえ

enableRemoteReplication

Snapshot をリモートストレージにレプリケートするかどうかを指定します。有効な値：

  • true：Snapshotがリモートストレージにレプリケートされます。

  • false：Snapshotはリモートストレージにレプリケートされません。

ブーリアン

正しくない

いいえ

ensureSerialCreation

以前の Snapshot レプリケーションが実行中の場合に Snapshot を作成しないように指定します。有効な値は次のとおりです。

  • true：これにより、一度にレプリケートされるSnapshotが1つだけになります。以前の Snapshot レプリケーションがまだ実行中の場合、新しい Snapshot の作成は失敗します。

  • false：デフォルト。別の Snapshot レプリケーションがまだ実行中の場合は、この Snapshot を作成できます。

ブーリアン

false

いいえ

expirationTime

Snapshot を削除するまでの時間を指定します。では使用できません retention。または `retention`どちらも指定しない場合、 `expirationTime`スナップショットは期限切れになりません。時刻の形式は、時間ベースの期限を表す ISO 8601 形式の日付文字列であり、それ以外の場合は期限切れになりません。を指定 `null`すると、Snapshotが永続的に保持されます。値をに設定 `fifo`すると、ボリューム上の他のFIFOスナップショットと比較して、スナップショットが先入れ先出し（FIFO）ベースで保持されます。使用可能な FIFO 領域がない場合、 API は失敗します。

ISO 8601 形式の日付文字列

なし

いいえ

name

グループ Snapshot の名前。名前を入力しない場合、グループ Snapshot の作成日時が使用されます。最大文字数は 255 文字です。

文字列

なし

いいえ

retention

このパラメータはパラメータと同じ `expirationTime`ですが、時刻の形式はHH：mm：ssです。またはの `retention`どちらも指定しない場合、 `expirationTime`スナップショットは期限切れになりません。

文字列

なし

いいえ

snapMirrorLabel

SnapMirror エンドポイントでの Snapshot 保持ポリシーを指定するために SnapMirror ソフトウェアで使用されるラベル。

文字列

なし

いいえ

volumes

コピー元のボリュームイメージの一意の ID 。

volumeID の配列

なし

はい

戻り値

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

名前

製品説明

タイプ

メンバー

グループの各メンバーのチェックサム、ボリューム ID 、 Snapshot ID のリスト。有効な値：

  • checksum ：保存された Snapshot のデータを表す短い文字列。このチェックサムを使用して、あとで他の Snapshot と比較してデータ内のエラーを検出できます。文字列

  • snapshotID ：新しい Snapshot の作成元 Snapshot の一意の ID 。Snapshot ID は、指定したボリュームの Snapshot の ID である必要があります。整数

  • volumeID ： Snapshot のソースボリュームの ID整数

JSON オブジェクトの配列

groupSnapshotID

新しいグループ Snapshot の一意の ID 。

グループ Snapshot 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