CreateVolumeメソッドを使用すると、クラスタに新しい空のボリュームを作成できます。作成したボリュームはすぐにiSCSI経由で接続できます。
QoS値を指定せずに作成したボリュームには、デフォルト値が使用されます。GetDefaultQoSメソッドを使用すると、ボリュームのデフォルト値を表示できます。
このメソッドの入力パラメータは次のとおりです。
| 名前 | 説明 | タイプ | デフォルト値 | 必須 |
|---|---|---|---|---|
| accountID | このボリュームを所有するアカウントのID。 | 整数 | なし | ○ |
| associateWithQoSPolicy | 指定したQoSポリシーにボリュームを関連付けます。有効な値は次のとおりです。
|
ブーリアン | true | × |
| attributes | JSONオブジェクト形式の名前と値のペアのリスト。JSONの書式指定文字を含め、1,000B（1KB）未満で指定する必要があります。 | JSONオブジェクト | なし | × |
| enable512e | 512バイトのセクター エミュレーションを有効にします。有効な値は次のとおりです。
|
ブーリアン | なし | ○ |
| enableSnapMirrorReplication | ボリュームをSnapMirrorエンドポイントでのレプリケーションに使用できるかどうかを決定します。有効な値は次のとおりです。
|
ブーリアン | false | × |
| name | ボリューム アクセス グループの名前（ユーザが指定可能）。一意である必要はありませんが、一意にすることを推奨します。1～64文字で指定します。 | 文字列 | なし | ○ |
| qos | このボリュームの初期QoS設定。指定しない場合、デフォルト値が使用されます。有効な値は次のとおりです。
|
QoSオブジェクト | なし | × |
| qosPolicyID | 指定したボリュームに適用するQoS設定が定義されたポリシーのID。このパラメータは、qosパラメータと同時に指定することはできません。 | 整数 | なし | × |
| totalSize | ボリュームの合計サイズ（バイト）。サイズは最も近いMB単位に切り上げられます。 | 整数 | なし | ○ |
このメソッドの戻り値は次のとおりです。
| 名前 | 説明 | タイプ |
|---|---|---|
| volume | 作成されたボリュームの情報を含むオブジェクト。 | volume |
| volumeID | 作成されたボリュームの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
}
}