版本資訊
建立Volume
建議變更
PDF
您可以使用「Create Volume」（建立磁碟區）方法、在叢集上建立新的空白磁碟區。一旦建立磁碟區、即可透過iSCSI連線至該磁碟區。
未指定QoS值所建立的磁碟區會使用預設值。您可以使用「GetDefaultQoS」方法來檢視磁碟區的預設值。
參數
此方法具有下列輸入參數：
| 名稱 | 說明 | 類型 | 預設值 | 必要 |
|---|---|---|---|---|
存取權 |
Volume的存取模式。如果包含此參數、則唯一支援的值為「napMirrorTarget」。 |
字串 |
無 |
否 |
《AccountID》 |
擁有此磁碟區的帳戶ID。 |
整數 |
無 |
是的 |
「associateWithQoSPolicy」 |
將磁碟區與指定的QoS原則建立關聯。可能值：
|
布林值 |
是的 |
否 |
屬性 |
Json物件格式的名稱-值配對清單。總屬性大小必須小於1000B或1KB、包括Json格式化字元。 |
Json物件 |
無 |
否 |
|
防止磁碟區在負載平衡與實際 IOPS 時移動。此設定從元素 12.8 開始提供，只有在啟用時才有效"Volume LoadBalanceOnActualIOPS"。可能值：
|
布林值 |
錯 |
否 |
「enable512e」 |
啟用512位元組區段模擬。可能值：
|
布林值 |
無 |
是的 |
「enableSnapMirrorReplication」 |
決定磁碟區是否可用於SnapMirror端點的複寫。可能值：
|
布林值 |
錯 |
否 |
《五大規模》 |
指定Volume支援的先進先出（FIFO）快照數量上限。請注意、FIFO和非FIFO快照都使用同一個磁碟區上可用的快照插槽集區。使用此選項可限制可用快照插槽的FIFO快照使用量。如果省略、此值預設為24。 |
整數 |
24 |
否 |
《我的快來大》 |
指定磁碟區保留的最小先進先出（FIFO）快照插槽數。這可確保如果您在非FIFO快照不會意外佔用過多的FIFO插槽的磁碟區上同時使用FIFO快照和非FIFO快照、它也能確保至少有這麼多的FIFO快照永遠可用。由於FIFO和非FIFO快照共享同一個資源池、因此「manifoSizes」可將可能的非FIFO快照總數減少相同數量。如果省略、則值預設為0。 |
整數 |
0 |
否 |
名稱 |
Volume存取群組名稱（可由使用者指定）。不需要是獨一無二的、但值得推薦。長度必須為1到64個字元。 |
字串 |
無 |
是的 |
QoS |
此Volume的初始服務品質設定。如果未指定任何值、則會使用預設值。可能值：
|
QoS物件 |
無 |
否 |
《qosPolicyID》 |
應將QoS設定套用至指定磁碟區的原則ID。此參數與「QoS」參數互不相容。 |
整數 |
無 |
否 |
"totalSiz" |
Volume的總大小（以位元組為單位）。大小會四捨五入至最接近的百萬位元組。 |
整數 |
無 |
是的 |
傳回值
此方法具有下列傳回值：
| 名稱 | 說明 | 類型 |
|---|---|---|
Volume |
包含新建立磁碟區相關資訊的物件。 |
|
Volume ID |
新建立磁碟區的磁碟區ID。 |
整數 |
曲線 |
曲線是一組金鑰值配對。金鑰是以位元組為單位的I/O大小。這些值代表以特定I/O大小執行IOP的成本。曲線的計算方式是以100 IOPS設定為4096位元組的作業方式。 |
Json物件 |
申請範例
此方法的要求類似於下列範例：
{
"method": "CreateVolume",
"params": {
"name": "testit",
"accountID": 22,
"dontMoveForIopsRebalance": true,
"totalSize": 100000000000,
"enable512e": false,
"attributes": {},
"qos": {
"minIOPS": 500,
"maxIOPS": 27000,
"burstIOPS": 27000,
"burstTime": 60
}
},
"id": 1
}
回應範例
此方法會傳回類似下列範例的回應：
{
"id": 1,
"result": {
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500,
"4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"volume": {
"access": "readWrite",
"accountID": 22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-02T13:03:02Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": true,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
"lastAccessTime": null,
"lastAccessTimeIO": null,
"minFifoSize": 0,
"name": "testit",
"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": "3365657500000140f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000003365657500000140",
"sliceCount": 0,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeConsistencyGroupUUID": "8ed68e57-13ee-47df-8381-29b125142718",
"volumeID": 320,
"volumePairs": [],
"volumeUUID": "e0e2c938-4ecd-4de9-a1be-f6b17c93ce5d"
},
"volumeID": 320
}
}
新的自版本
9.6
