Skip to main content
Element Software
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

ModifyVolume

貢獻者 netapp-pcarriga
PDF

您可以使用此 `ModifyVolume`方法修改現有磁碟區上的設定。您可以一次修改一個磁碟區、並立即進行變更。

如果您在修改磁碟區時未指定QoS值、則這些值與修改前的相同。您可以執行方法來擷取新建立磁碟區的預設 QoS 值 GetDefaultQoS。

當您需要增加正在複寫的磁碟區大小時、請依照下列順序執行此動作、以避免發生複寫錯誤：

  1. 利用「複製目標」存取來增加磁碟區的大小。

  2. 利用讀寫存取權來增加來源或磁碟區的大小。

確保目標和來源磁碟區大小相同。

註 如果您將存取狀態變更為鎖定或複製目標、則所有現有的iSCSI連線都會終止。

參數

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

名稱 說明 類型 預設值 必要

Volume ID

要修改之磁碟區的磁碟區ID。

整數

無

是的

存取

允許存取磁碟區。可能值：

  • readOnly：只允許讀取作業。

  • readWrite：允許讀寫。

  • locked：不允許讀取或寫入。如果未指定、存取值不會變更。

  • replicationTarget：將某個 Volume 識別為配對的一組 Volume 的目標 Volume 。如果Volume未配對、存取狀態會鎖定。如果未指定值、則存取值不會變更。

  • snapMirrorTarget：將磁碟區識別為 SnapMirror 複寫的目標磁碟區。

字串

無

否

帳戶ID

重新指派磁碟區的AccountID。如果未指定、則會使用先前的帳戶名稱。

整數

無

否

AssociatedWithQoSPolicy

將磁碟區與指定的QoS原則建立關聯。可能值：

  • true：將磁碟區與在 QoPolicyID 參數中指定的 QoS 原則建立關聯。

  • false：請勿將磁碟區與在 QoPolicyID 參數中指定的 QoS 原則建立關聯。如果為假、則會移除任何現有的原則關聯、無論您是否在QoSPolicy參數中指定QoS原則。

布林值

無

否

屬性

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

Json物件

無

否

CREATETIM

ISO 8601日期字串、設定為新的Volume建立日期。如果設定為true、則為必要。

ISO 8601字串

無

否

已啓用SnapMirrorReplication

決定磁碟區是否可用於SnapMirror端點的複寫。可能值：

  • true

  • false

布林值

錯

否

五分大小

指定Volume支援的先進先出（FIFO）快照數量上限。請注意、FIFO和非FIFO快照都使用同一個磁碟區上可用的快照插槽集區。使用此選項可限制可用快照插槽的FIFO快照使用量。請注意、您無法將此值修改為小於目前的FIFO快照計數。

整數

無

否

最小大小

指定僅保留給先進先出（FIFO）快照的快照插槽數。由於FIFO和非FIFO快照共用相同的資源池、因此minFifoSizer參數會將可能的非FIFO快照總數減少相同數量。請注意、您無法修改此值、使其與目前的非FIFO快照計數發生衝突。

整數

無

否

模式

Volume複寫模式。可能值：

  • asynch：在寫入目標之前，等待系統確認資料儲存在來源上。

  • sync：不需要等待來源的資料傳輸確認、即可開始將資料寫入目標。

字串

無

否

QoS

此磁碟區的新服務品質設定。如果未指定、則不會變更QoS設定。可能值：

  • minIOPS

  • maxIOPS

  • burstIOPS

QoS

無

否

qosPolicyID

應將QoS設定套用至指定磁碟區的原則ID。此參數與QoS參數互不相容。

整數

無

否

設定建立時間

設為true可變更磁碟區建立的記錄日期。

布林值

無

否

累計大小

磁碟區的新大小（以位元組為單位）。1000000000等於1GB。大小會四捨五入至最接近的MB大小。此參數只能用於增加磁碟區的大小。

整數

無

否

傳回值

此方法具有下列傳回值：

名稱

說明

類型

Volume

包含新修改磁碟區相關資訊的物件。

Volume

申請範例

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

{
  "method": "ModifyVolume",
  "params": {
     "volumeID": 5,
     "attributes": {
        "name1": "value1",
        "name2": "value2",
        "name3": "value3"
     },
     "qos": {
        "minIOPS": 60,
        "maxIOPS": 100,
        "burstIOPS": 150,
        "burstTime": 60
     },
      "access" :"readWrite"
     },
      "totalSize": 20000000000,
     "id": 1
}

回應範例

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

{
  "id": 1,
  "result": {
      "volume": {
          "access": "readWrite",
          "accountID": 1,
          "attributes": {
              "name1": "value1",
              "name2": "value2",
              "name3": "value3"
          },
          "blockSize": 4096,
          "createTime": "2016-03-28T16:16:13Z",
          "deleteTime": "",
          "enable512e": true,
          "iqn": "iqn.2010-01.com.solidfire:jyay.1459181777648.5",
          "name": "1459181777648",
          "purgeTime": "",
          "qos": {
              "burstIOPS": 150,
              "burstTime": 60,
              "curve": {
                  "4096": 100,
                  "8192": 160,
                  "16384": 270,
                  "32768": 500,
                  "65536": 1000,
                  "131072": 1950,
                  "262144": 3900,
                  "524288": 7600,
                  "1048576": 15000
              },
              "maxIOPS": 100,
              "minIOPS": 60
          },
          "scsiEUIDeviceID": "6a79617900000005f47acc0100000000",
          "scsiNAADeviceID": "6f47acc1000000006a79617900000005",
          "sliceCount": 1,
          "status": "active",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeAccessGroups": [
              1
          ],
          "volumeID": 5,
          "volumePairs": []
      }
  }
}

新的自版本

9.6

如需詳細資訊、請參閱

GetDefaultQoS