CreateVolume を使用します
変更を提案
PDF
メソッドを使用すると、クラスタに新しい空のボリュームを作成できます CreateVolume。ボリュームが作成されるとすぐに、そのボリュームを iSCSI 経由で接続できます。
QoS 値を指定せずに作成したボリュームには、デフォルト値が使用されます。メソッドを使用すると、ボリュームのデフォルト値を表示できます GetDefaultQoS。
パラメータ
このメソッドの入力パラメータは次のとおりです。
| 名前 | 製品説明 | タイプ | デフォルト値 | 必須 |
|---|---|---|---|---|
|
ボリュームのアクセスモード。このパラメータを指定した場合、サポートされる値はのみです |
文字列 |
なし |
いいえ |
|
このボリュームを所有するアカウントの ID 。 |
整数 |
なし |
はい |
|
指定した QoS ポリシーにボリュームを関連付けます。有効な値：
|
ブーリアン |
正しい |
いいえ |
|
JSON オブジェクト形式の名前と値のペアのリスト。属性の合計サイズは、 JSON 形式の文字を含めて、 1000 B 未満または 1KB 未満にする必要があります。 |
JSON（オブジェクト） |
なし |
いいえ |
|
512 バイトのセクターエミュレーションを有効にします。有効な値：
|
ブーリアン |
なし |
はい |
|
ボリュームを SnapMirror エンドポイントでのレプリケーションに使用できるかどうかを指定します。有効な値：
|
ブーリアン |
正しくない |
いいえ |
|
ボリュームでサポートされる FIFO （ First-In First-Out ）スナップショットの最大数を指定します。FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上で使用可能なスナップショットスロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショットスロットの FIFO スナップショットの消費を制限します。省略した場合、デフォルト値は 24 です。 |
整数 |
24 |
いいえ |
|
ボリュームによって予約された FIFO （ First-In First-Out ）スナップショットスロットの最小数を指定します。これにより、 FIFO 以外のスナップショットが意図せずに FIFO スロットを過剰に消費しないボリュームで FIFO スナップショットと非 FIFO スナップショットの両方を使用する場合に、保証されます。また、少なくともこの多くの FIFO スナップショットが常に利用可能であることを保証します。FIFOスナップショットと非FIFOスナップショットは同じプールを共有するため、は `minFifoSize`可能な非FIFOスナップショットの総数を同じ量だけ減らします。省略した場合、デフォルト値は 0 です。 |
整数 |
0 |
いいえ |
|
ボリュームアクセスグループの名前（ユーザが指定可能）。固有である必要はありませんが、一意にすることを推奨します1~64 文字で指定します。 |
文字列 |
なし |
はい |
|
このボリュームの初期 QoS 設定。指定しない場合はデフォルト値が使用されます。有効な値：
|
QoS オブジェクト |
なし |
いいえ |
|
指定したボリュームに適用する QoS 設定が定義されたポリシーの ID 。このパラメータは、パラメータと同時に指定することはできません |
整数 |
なし |
いいえ |
|
ボリュームの合計サイズ（バイト）。サイズは最も近い MB 単位に切り上げられます。 |
整数 |
なし |
はい |
戻り値
このメソッドの戻り値は次のとおりです。
名前 |
製品説明 |
タイプ |
ボリューム |
作成されたボリュームの情報を含むオブジェクト。 |
|
ボリュームID |
作成されたボリュームの ID 。 |
整数 |
カーブ（ Curve ） |
curve は一連のキーと値のペアです。キーはバイト単位の I/O サイズです。値は、特定の I/O サイズで IOP を実行する際のコストを表します。curve は、 100 IOPS での 4 、 096 バイトの処理セットと比較して計算されます。 |
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