ボリュームの作成
変更を提案
PDF
使用することができます `CreateVolume`クラスター上に新しい空のボリュームを作成する方法。ボリュームが作成されるとすぐに、ボリュームは iSCSI 経由で接続できるようになります。
QoS 値を指定せずに作成されたボリュームでは、デフォルト値が使用されます。ボリュームのデフォルト値を表示するには、 `GetDefaultQoS`方法。
パラメータ
このメソッドには次の入力パラメータがあります。
| Name | 説明 | タイプ | デフォルト値 | 必須 |
|---|---|---|---|---|
|
ボリュームのアクセス モード。このパラメータが含まれている場合、サポートされる値は |
string |
なし |
いいえ |
|
このボリュームを所有するアカウントの ID。 |
integer |
なし |
はい |
|
指定された QoS ポリシーにボリュームを関連付けます。有効な値は次のとおりです。
|
ブーリアン |
true |
いいえ |
|
JSON オブジェクト形式の名前と値のペアのリスト。属性の合計サイズは、JSON 形式文字を含めて 1000B (1KB) 未満である必要があります。 |
JSONオブジェクト |
なし |
いいえ |
|
実際の IOPS で負荷分散するときにボリュームが移動しないようにします。この設定はElement 12.8以降で利用可能で、"実際のIOPSでのボリューム負荷バランス"が有効になります。有効な値は次のとおりです。
注: 高可用性（ノード障害）のバランス調整は、 |
ブーリアン |
false |
いいえ |
|
512 バイト セクター エミュレーションを有効にします。有効な値は次のとおりです。
|
ブーリアン |
なし |
はい |
|
ボリュームをSnapMirrorエンドポイントでのレプリケーションに使用できるかどうかを決定します。有効な値は次のとおりです。
|
ブーリアン |
false |
いいえ |
|
ボリュームでサポートされる先入れ先出し (FIFO) スナップショットの最大数を指定します。 FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上の使用可能なスナップショット スロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショット スロットの FIFO スナップショットの消費を制限します。省略した場合、値はデフォルトで 24 になります。 |
integer |
24 |
いいえ |
|
ボリュームによって予約される先入れ先出し (FIFO) スナップショット スロットの最小数を指定します。これにより、ボリューム上で FIFO スナップショットと非 FIFO スナップショットの両方を使用している場合に、非 FIFO スナップショットが意図せず FIFO スロットを過剰に消費することがなくなります。また、少なくともこれだけの数の FIFO スナップショットが常に利用可能であることも保証します。 FIFOスナップショットと非FIFOスナップショットは同じプールを共有するため、 `minFifoSize`可能な非 FIFO スナップショットの合計数も同じ量だけ減ります。省略した場合、値はデフォルトで 0 になります。 |
integer |
0 |
いいえ |
|
ボリューム アクセス グループの名前 (ユーザーが指定できます)。一意である必要はありませんが、一意であることが推奨されます。長さは 1 ～ 64 文字にする必要があります。 |
string |
なし |
はい |
|
このボリュームの初期のサービス品質設定。何も指定されていない場合はデフォルト値が使用されます。有効な値は次のとおりです。
|
QoSオブジェクト |
なし |
いいえ |
|
指定されたボリュームに QoS 設定を適用するポリシーの ID。このパラメータは、 `qos`パラメータ。 |
integer |
なし |
いいえ |
|
ボリュームの合計サイズ（バイト単位）。サイズは最も近いメガバイトに切り上げられます。 |
integer |
なし |
はい |
戻り値
このメソッドには次の戻り値があります。
| Name | 説明 | タイプ |
|---|---|---|
音量 |
新しく作成されたボリュームに関する情報を含むオブジェクト。 |
|
volumeID |
新しく作成されたボリュームのボリュームID。 |
integer |
曲線 |
曲線はキーと値のペアのセットです。キーはバイト単位の 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