建立Volume
建議變更
PDF
您可以使用此 `CreateVolume`方法在叢集上建立新的空白磁碟區。一旦建立磁碟區、即可透過iSCSI連線至該磁碟區。
未指定QoS值所建立的磁碟區會使用預設值。您可以使用方法檢視 Volume 的預設值 GetDefaultQoS。
參數
此方法具有下列輸入參數：
| 名稱 | 說明 | 類型 | 預設值 | 必要 |
|---|---|---|---|---|
|
Volume的存取模式。如果包含此參數，則唯一支援的值為 |
字串 |
無 |
否 |
|
擁有此磁碟區的帳戶ID。 |
整數 |
無 |
是的 |
|
將磁碟區與指定的QoS原則建立關聯。可能值：
|
布林值 |
是的 |
否 |
|
Json物件格式的名稱-值配對清單。總屬性大小必須小於1000B或1KB、包括Json格式化字元。 |
Json物件 |
無 |
否 |
|
啟用512位元組區段模擬。可能值：
|
布林值 |
無 |
是的 |
|
決定磁碟區是否可用於SnapMirror端點的複寫。可能值：
|
布林值 |
錯 |
否 |
|
指定Volume支援的先進先出（FIFO）快照數量上限。請注意、FIFO和非FIFO快照都使用同一個磁碟區上可用的快照插槽集區。使用此選項可限制可用快照插槽的FIFO快照使用量。如果省略、則值預設為24。 |
整數 |
24 |
否 |
|
指定磁碟區保留的最小先進先出（FIFO）快照插槽數。這可確保如果您在非FIFO快照不會意外佔用過多的FIFO插槽的磁碟區上同時使用FIFO快照和非FIFO快照、它也能確保至少有這麼多的FIFO快照永遠可用。由於 FIFO 和非 FIFO 快照共用同一個集區、因此 `minFifoSize`可將可能的非 FIFO 快照總數減少相同數量。如果省略、則值預設為0。 |
整數 |
0 |
否 |
|
Volume存取群組名稱（可由使用者指定）。不需要是獨一無二的、但值得推薦。長度必須為1到64個字元。 |
字串 |
無 |
是的 |
|
此Volume的初始服務品質設定。如果未指定任何值、則會使用預設值。可能值：
|
QoS物件 |
無 |
否 |
|
應將QoS設定套用至指定磁碟區的原則ID。此參數與參數互斥 |
整數 |
無 |
否 |
|
Volume的總大小（以位元組為單位）。大小會四捨五入至最接近的百萬位元組。 |
整數 |
無 |
是的 |
傳回值
此方法具有下列傳回值：
名稱 |
說明 |
類型 |
Volume |
包含新建立磁碟區相關資訊的物件。 |
|
Volume ID |
新建立磁碟區的磁碟區ID。 |
整數 |
曲線 |
曲線是一組金鑰值配對。金鑰是以位元組為單位的I/O大小。這些值代表以特定I/O大小執行IOP的成本。曲線的計算方式是以100 IOPS設定為4096位元組的作業方式。 |
Json物件 |
申請範例
此方法的要求類似於下列範例：
{
"method": "CreateVolume",
"params": {
"name": "mysqldata",
"accountID": 1,
"totalSize": 107374182400,
"enable512e": false,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"qos": {
"minIOPS": 50,
"maxIOPS": 500,
"burstIOPS": 1500,
"burstTime": 60
}
},
"id": 1
}
回應範例
此方法會傳回類似下列範例的回應：
{
"id": 1,
"result": {
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"volume": {
"access": "readWrite",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-03-31T22:20:22Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
"name": "mysqldata",
"purgeTime": "",
"qos": {
"burstIOPS": 1500,
"burstTime": 60,
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"maxIOPS": 500,
"minIOPS": 50
},
"scsiEUIDeviceID": "6a796179000002a5f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a796179000002a5",
"sliceCount": 0,
"status": "active",
"totalSize": 107374182400,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 677,
"volumePairs": []
},
"volumeID": 677
}
}
新的自版本
9.6