Skip to main content
Element Software
12.5 and 12.7
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

建立Snapshot

貢獻者
PDF

您可以使用「Create Snapshot」建立磁碟區的時間點複本。您可以從任何磁碟區或現有的快照建立快照。

如果您未使用此API方法提供SnapshotID、則會從磁碟區的作用中分支建立快照。如果要將建立快照的磁碟區複寫到遠端叢集、也可以將快照複寫到相同的目標。使用enableRemoteReplication參數來啟用快照複寫。

註 如果叢集完整度處於階段1、2或3、您可以建立快照。叢集完整度達到階段4或5時、您無法建立快照。

參數

此方法具有下列輸入參數：

名稱 說明 類型 預設值 必要

屬性

Json物件格式的名稱-值配對清單。

Json物件

無

否

「enableRemoteReplication」

指定是否將快照複寫至遠端儲存設備。可能值：

  • 「真的」：快照將複寫到遠端儲存設備。

  • 「假」：快照不會複寫到遠端儲存設備。

布林值

錯

否

「EnureSerialCreation」

指定如果正在進行先前的快照複寫、則不應建立快照。可能的值包括：

  • 「真的」：這可確保一次只複寫一個快照。如果先前的快照複寫仍在進行中、建立新快照將會失敗。

  • 「假」：預設。如果另一個快照複寫仍在進行中、則允許建立此快照。

布林值

「假」

否

過期時間

指定快照可移除的時間。無法與"REtion"一起使用。如果未指定過期時間或保留時間、則快照不會過期。時間格式為ISO 8601日期字串、適用於基於時間的到期日、否則將不會過期。如果值為「null」、則會永久保留快照。如果值為「fifo」、則快照將會以先進先出的方式保留、而非與磁碟區上的其他FIFO快照相比。如果沒有可用的FIFO空間、API將會失敗。

字串

無

否

名稱

快照的名稱。如果未輸入名稱、則會使用拍攝快照的日期和時間。名稱長度上限為255個字元。

字串

無

否

《狀態》

此參數與「過期時間」參數相同、但時間格式為hh：mms如果既未指定「過期時間」、也未指定「保留時間」、則快照不會過期。

字串

無

否

「napMirrorLabel」

SnapMirror軟體用來指定SnapMirror端點上的快照保留原則的標籤。

字串

無

否

「快照ID」

用於建立新快照的快照的唯一ID。傳遞的SnapshotID必須是指定磁碟區上的快照。

整數

無

否

「volumeID」

要複製之Volume映像的唯一ID。

整數

無

是的

傳回值

此方法具有下列傳回值：

名稱

說明

類型

Checksum

代表儲存快照中正確數字的字串。此Checksum稍後可用於比較其他快照、以偵測資料中的錯誤。

字串

Snapshot ID

新快照的唯一ID。

Snapshot ID

Snapshot

包含新建立之快照相關資訊的物件。

Snapshot

申請範例

此方法的要求類似於下列範例：

{
   "method": "CreateSnapshot",
   "params": {
      "volumeID": 1
   },
   "id": 1
}

回應範例

此方法會傳回類似下列範例的回應：

{
  "id": 1,
  "result": {
    "checksum": "0x0",
      "snapshot": {
        "attributes": {},
        "checksum": "0x0",
        "createTime": "2016-04-04T17:14:03Z",
        "enableRemoteReplication": false,
        "expirationReason": "None",
        "expirationTime": null,
        "groupID": 0,
        "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000",
        "name": "2016-04-04T17:14:03Z",
        "snapshotID": 3110,
        "snapshotUUID": "6f773939-c239-44ca-9415-1567eae79646",
        "status": "done",
        "totalSize": 5000658944,
        "virtualVolumeID": null,
        "volumeID": 1
      },
        "snapshotID": 3110
  }
}

例外狀況

當調用「建立Snapshot」API且無法建立快照時、會顯示xNotPrimary例外狀況。這是預期的行為。重試「建立Snapshot」API呼叫。

新的自版本

9.6