修改音量
建議變更
PDF
你可以使用 `ModifyVolume`修改現有磁碟區設定的方法。您可以一次修改一個卷，更改會立即生效。
如果在修改磁碟區時未指定 QoS 值，則這些值將與修改前保持一致。您可以透過執行以下命令來檢索新建立磁碟區的預設 QoS 值： `GetDefaultQoS`方法。
當您需要增加正在複製的磁碟區的大小時，請按以下順序操作，以防止複製錯誤：
-
使用 replicationTarget 存取權增加磁碟區的大小。
-
增加具有讀寫存取權限的來源或磁碟區的大小。
確保目標磁碟區和來源磁碟區的大小相同。
|
如果將存取狀態變更為 locked 或 replicationTarget，則所有現有的 iSCSI 連線都會終止。 |
參數
此方法有以下輸入參數：
| Name | 描述 | 類型 | 預設值 | 必需的 |
|---|---|---|---|---|
卷 ID |
要修改的磁碟區的 volumeID。 |
整數 |
沒有任何 |
是的 |
使用權 |
允許存取該卷。可能的值：
|
細繩 |
沒有任何 |
不 |
帳戶ID |
磁碟區被重新指派給的帳號 ID。如果沒有指定，則使用先前的帳戶名稱。 |
整數 |
沒有任何 |
不 |
與QoS策略關聯 |
將磁碟區與指定的QoS策略關聯起來。可能的值：
|
布林值 |
沒有任何 |
不 |
屬性 |
JSON 物件格式的名稱-值對清單。 |
JSON 物件 |
沒有任何 |
不 |
創建時間 |
若要設定為新磁碟區建立日期的 ISO 8601 日期字串。如果 setCreateTime 設定為 true，則此參數為必填項。 |
ISO 8601字串 |
沒有任何 |
不 |
不要移動 Iops 重新平衡 |
使用實際 IOPS 進行負載平衡時，防止磁碟區移動。此設定從 Element 12.8 版本開始可用，僅在以下情況下生效："VolumeLoadBalanceOnActualIOPS"已啟用。可能的值：
注意：高可用性（節點故障）的負載平衡優先於 |
布林值 |
錯誤的 |
不 |
啟用 SnapMirror 複製 |
確定該磁碟區是否可用於與SnapMirror端點進行複製。可能的值：
|
布林值 |
錯誤的 |
不 |
先進先出大小 |
指定磁碟區支援的最大先進先出 (FIFO) 快照數。請注意，FIFO 快照和非 FIFO 快照都使用磁碟區上相同的可用快照槽池。使用此選項可限制 FIFO 快照對可用快照插槽的消耗。請注意，您不能將此值修改為小於目前 FIFO 快照計數。 |
整數 |
沒有任何 |
不 |
最小FIFO大小 |
指定僅用於先進先出 (FIFO) 快照的快照槽數量。由於 FIFO 和非 FIFO 快照共用同一個池，因此 minFifoSize 參數會將可能的非 FIFO 快照的總數減少相同的數量。請注意，您不能修改此值，使其與目前的非 FIFO 快照計數衝突。 |
整數 |
沒有任何 |
不 |
模式 |
卷複製模式。可能的值：
|
細繩 |
沒有任何 |
不 |
服務品質 |
本卷新的服務品質設定。如果未指定，則 QoS 設定不會變更。可能的值：
|
沒有任何 |
不 |
|
qosPolicyID |
若要將 QoS 設定套用至指定磁碟區的策略的 ID。此參數與 QoS 參數互斥。 |
整數 |
沒有任何 |
不 |
設定創建時間 |
設定為 true 可變更磁碟區建立記錄日期。 |
布林值 |
沒有任何 |
不 |
總大小 |
卷的新大小（以位元組為單位）。 1000000000 等於 1GB。檔案大小向上取整到最接近的兆位元組。此參數只能用於增加體積的大小。 |
整數 |
沒有任何 |
不 |
傳回值
此方法傳回以下值：
| Name | 描述 | 類型 |
|---|---|---|
體積 |
包含有關新修改卷的資訊的物件。 |
請求範例
該方法的請求類似於以下範例：
{
"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