ModifyVolumes
建議變更
PDF
您可以使用此 `ModifyVolumes`方法一次最多設定 500 個現有磁碟區。變更會立即生效。如果無法修改任何指定的磁碟區、則 `ModifyVolumes`不會變更任何指定的磁碟區。
如果您在修改磁碟區時未指定QoS值、則每個磁碟區的QoS值將維持不變。您可以執行方法來擷取新建立磁碟區的預設 QoS 值 GetDefaultQoS。
當您需要增加要複寫的磁碟區大小時、請依照下列順序執行此動作、以避免發生複寫錯誤：
-
利用「複製目標」存取來增加磁碟區的大小。
-
利用讀寫存取權來增加來源或磁碟區的大小。
確保目標和來源磁碟區大小相同。
|
如果您將存取狀態變更為鎖定或複製目標、則所有現有的iSCSI連線都會終止。 |
參數
此方法具有下列輸入參數：
名稱 |
說明 |
類型 |
預設值 |
必要 |
存取 |
允許存取磁碟區。可能值：
|
字串 |
無 |
否 |
帳戶ID |
重新指派磁碟區的AccountID。如果未指定、則會使用先前的帳戶名稱。 |
整數 |
無 |
否 |
AssociatedWithQoSPolicy |
將磁碟區與指定的QoS原則建立關聯。可能值：
|
布林值 |
無 |
否 |
屬性 |
Json物件格式的名稱-值配對清單。 |
Json物件 |
無 |
否 |
CREATETIM |
ISO 8601日期字串、設定為新的Volume建立日期。如果設定為true、則為必要。 |
ISO 8601字串 |
無 |
否 |
已啓用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 ID |
要修改之磁碟區的磁碟區ID清單。 |
整數陣列 |
無 |
是的 |
傳回值
此方法具有下列傳回值：
名稱 |
說明 |
類型 |
Volume |
包含每個新修改磁碟區資訊的物件陣列。 |
Volume陣列 |
申請範例
此方法的要求類似於下列範例：
{
"method": "ModifyVolumes",
"params": {
"volumeIDs": [2,3],
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"qos": {
"minIOPS": 50,
"maxIOPS": 100,
"burstIOPS": 150,
"burstTime": 60
},
"access" : "replicationTarget"
},
"totalSize": 80000000000,
"id": 1
}
回應範例
此方法會傳回類似下列範例的回應：
{
"id": 1,
"result": {
"volumes": [
{
"access": "replicationTarget",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-04-06T17:25:13Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:jo73.2",
"name": "doctest1",
"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": 50
},
"scsiEUIDeviceID": "6a6f373300000002f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a6f373300000002",
"sliceCount": 1,
"status": "active",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 2,
"volumePairs": []
},
{
"access": "replicationTarget",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-04-06T17:26:31Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:jo73.3",
"name": "doctest2",
"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": 50
},
"scsiEUIDeviceID": "6a6f373300000003f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a6f373300000003",
"sliceCount": 1,
"status": "active",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 3,
"volumePairs": []
}
]
}
}
新的自版本
9.6