版本資訊
ModifyVolume
建議變更
PDF
您可以使用「磁碟區」方法來修改現有磁碟區的設定。您可以一次修改一個磁碟區、並立即進行變更。
如果您在修改磁碟區時未指定QoS值、則這些值與修改前的相同。您可以執行「GetDefaultQoS」方法來擷取新建立磁碟區的預設QoS值。
當您需要增加正在複寫的磁碟區大小時、請依照下列順序執行此動作、以避免發生複寫錯誤：
-
利用「複製目標」存取來增加磁碟區的大小。
-
利用讀寫存取權來增加來源或磁碟區的大小。
確保目標和來源磁碟區大小相同。
|
如果您將存取狀態變更為鎖定或複製目標、則所有現有的iSCSI連線都會終止。 |
參數
此方法具有下列輸入參數：
| 名稱 | 說明 | 類型 | 預設值 | 必要 |
|---|---|---|---|---|
Volume ID |
要修改之磁碟區的磁碟區ID。 |
整數 |
無 |
是的 |
存取 |
允許存取磁碟區。可能值：
|
字串 |
無 |
否 |
帳戶ID |
重新指派磁碟區的AccountID。如果未指定、則會使用先前的帳戶名稱。 |
整數 |
無 |
否 |
AssociatedWithQoSPolicy |
將磁碟區與指定的QoS原則建立關聯。可能值：
|
布林值 |
無 |
否 |
屬性 |
Json物件格式的名稱-值配對清單。 |
Json物件 |
無 |
否 |
CREATETIM |
ISO 8601日期字串、設定為新的Volume建立日期。如果設定為true、則為必要。 |
ISO 8601字串 |
無 |
否 |
dontMoveforIopsRebalance |
防止磁碟區在負載平衡與實際 IOPS 時移動。此設定從元素 12.8 開始提供，只有在啟用時才有效"Volume LoadBalanceOnActualIOPS"。可能值：
|
布林值 |
錯 |
否 |
已啓用SnapMirrorReplication |
決定磁碟區是否可用於SnapMirror端點的複寫。可能值：
|
布林值 |
錯 |
否 |
五分大小 |
指定Volume支援的先進先出（FIFO）快照數量上限。請注意、FIFO和非FIFO快照都使用同一個磁碟區上可用的快照插槽集區。使用此選項可限制可用快照插槽的FIFO快照使用量。請注意、您無法將此值修改為小於目前的FIFO快照計數。 |
整數 |
無 |
否 |
最小大小 |
指定僅保留給先進先出（FIFO）快照的快照插槽數。由於FIFO和非FIFO快照共用相同的資源池、因此minFifoSizer參數會將可能的非FIFO快照總數減少相同數量。請注意、您無法修改此值、使其與目前的非FIFO快照計數發生衝突。 |
整數 |
無 |
否 |
模式 |
Volume複寫模式。可能值：
|
字串 |
無 |
否 |
QoS |
此磁碟區的新服務品質設定。如果未指定、則不會變更QoS設定。可能值：
|
無 |
否 |
|
qosPolicyID |
應將QoS設定套用至指定磁碟區的原則ID。此參數與QoS參數互不相容。 |
整數 |
無 |
否 |
設定建立時間 |
設為true可變更磁碟區建立的記錄日期。 |
布林值 |
無 |
否 |
累計大小 |
磁碟區的新大小（以位元組為單位）。1000000000等於1GB。大小會四捨五入至最接近的MB大小。此參數只能用於增加磁碟區的大小。 |
整數 |
無 |
否 |
傳回值
此方法具有下列傳回值：
| 名稱 | 說明 | 類型 |
|---|---|---|
Volume |
包含新修改磁碟區相關資訊的物件。 |
申請範例
此方法的要求類似於下列範例：
{
"method": "ModifyVolume",
"params": {
"volumeID": 319,
"access": "readWrite",
"dontMoveForIopsRebalance": false
},
"id": 1
}
回應範例
此方法會傳回類似下列範例的回應：
{
"id": 1,
"result": {
"volume": {
"access": "readWrite",
"accountID":22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-01T19:39:40Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": false,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:3eeu.suite40.319",
"lastAccessTime": "2024-04-02T12:41:34Z",
"lastAccessTimeIO": "2024-04-01T20:41:19Z",
"minFifoSize": 0,
"name": "suite40",
"previousProtectionScheme": null,
"purgeTime": "",
"qos": {
"burstIOPS": 27000,
"burstTime": 60,
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500, "4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"maxIOPS": 27000,
"minIOPS": 500
},
"qosPolicyID": null,
"scsiEUIDeviceID": "336565750000013ff47acc0100000000",
"scsiNAADeviceID": "6f47acc100000000336565750000013f",
"sliceCount": 1,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [
22
],
"volumeConsistencyGroupUUID": "3003109e-6e75-444c-8cee-470d641a09c3",
"volumeID": 319,
"volumePairs": [],
"volumeUUID": "78203136-b0eb-454b-9f67-2c867ec7d7bb"
}
}
}
新的自版本
9.6
