Volumeの作成
POST /volume概要説明
新規にVolumeを作成します。
以下のTypeのVolumeの作成はETERNUS RESTful APIではサポートしません。
WSV
SDPV
SDV
FTV
作成したVolumeのHrefは、「GET /job/{job_id}」のresource_href_listで確認できます。
テナントユーザーの場合、TPV以外のVolumeを作成することはできません。
リクエスト例
Thin Provisioning Pool ID 0 に容量が40GBのVolume (name = sample_vol) を作成する場合の例です。
$ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/volume" -d '{"name":"sample_vol","capacity":40960,"tpp_id":0}'RAID Group ID 10 に容量が5GBのコピー先保護が有効なVolume (name = test_vol) を3つ作成する場合の例です。
$ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/volume" -d '{"name":"test_vol","capacity":5120,"raidgroup_id":10,"count":3,"is_copy_protection_enabled":"true"}'
レスポンス例
{
"job_id": 8192001,
"job_href": "/api/v1/job/8192001"
}
Parameters
REQUEST BODY
| name
(required) |
string Volume名。 "count"で2以上の数値を指定した場合、Volume名の末尾に十進数の通し番号が自動で付与されます。 付与される通し番号の開始番号を"start_numer"で指定できます。 付与される通し番号の桁数を"number_of_digits"で指定できます。 例えば、"name"を"Volume#"、"count"を2、"start_number"を10、"number_of_digits"を3と指定した場合、作成されるVolumeのVolume名は「Volume#010」「Volume#011」になります。 入力条件：
|
| capacity
(required) |
integer Volumeの容量。 単位はMBです。 入力条件：
|
| tpp_id | integer 作成先Thin Provisioning PoolのID。 Volumeの作成先をThin Provisioning Poolにする場合は、本項目の設定は必須です。 入力条件：
|
| raidgroup_id | integer 作成先RAID GroupのID。 Volumeの作成先をRAID Groupにする場合は指定が必須です。 入力条件：
|
| volume_number | integer 作成するVolumeのVolume Number。 省略した場合、自動で採番します。 入力条件：
|
| count | integer Default: 1 Volumeの作成数。 入力条件：
|
| start_number | integer Default: 0 複数Volume作成時にVolume名の末尾に付加する通し番号の開始番号。 入力条件：
|
| number_of_digits | integer Default: 1 複数Volume作成時にVolume名の末尾に付加する通し番号の桁数。 入力条件：
|
| is_data_reduction_disabled | boolean Default: false Data Reduction無効化設定。 trueを指定した場合、作成するVolumeへ書き込まれるデータへのDeduplication and/or Compressionを無効化します。 入力条件：
|
| is_copy_protection_enabled | boolean Default: false Copy先保護設定。 trueを指定した場合、VolumeがCopy先として使用できなくなります。 想定外のコピーによるデータ破壊を防ぎたい場合に指定します。 入力条件：
|
| is_exc_disabled | boolean Default: false Extreme Cache Pool設定。 trueを指定した場合、作成したVolumeに対してアクセスする際に、Extreme Cache Poolを使用しません。 入力条件：
|
| is_thick_provisioned | boolean Default: false Allocation方式。 trueを指定した場合、Volume作成時に容量分の物理領域が割り当てられています。 Thin Provisioning Poolの物理容量枯渇によるシステム停止を防止したい場合に指定します。 入力条件：
|
| attention | integer Default: 80 ホストセンスが報告されるUsed Rateの閾値。 単位は%です。 入力条件：
|
| is_cm_encryption_enabled | boolean Default: false CMによる暗号化。 trueを指定した場合、Volume内のデータがCMによって暗号化されます。 入力条件：
|
Responses
正常にジョブ登録できた場合、HTTPステータスコードが202 (Accepted)となりレスポンスボディを応答します。
RESPONSE BODY
| job_id | integer Job ID。 |
| job_href | string JobのResourceへのLink。 |