CreateVolume
処理概要
ディスクを新規作成します。
サーバーを指定するためには、サーバー名が必要です。削除済みのサーバーを指定した、 管理外のサーバーを指定した、起動中･停止中以外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。 同様に、対象ゾーンで作成できないディスクサイズおよびディスクタイプの値･規定外の値を指定した、すでに存在するディスク名を指定した、 利用料金タイプに無効な値を指定したなどの場合は、エラーが返されます。
作成したディスクのゾーンは指定したサーバーと同一のゾーンになります。
指定するパラメーター
| パラメーター | 説明 | 必須 | サンプル値 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Size | ディスクサイズ 1GB単位の場合
100GB単位の場合
|
○ | 200 | ||||||||||||
| SnapshotId | ※指定不可 Type : String |
||||||||||||||
| AvailabilityZone | ※指定不可 Type : String |
||||||||||||||
| VolumeId | ディスク名 Type : String Default : 英数8文字 （システム発行） |
disk01 | |||||||||||||
| DiskType | ディスクタイプ Type : String 値 : 2 (標準ディスク) | 3 (高速ディスクA) | 4 (高速ディスクB) | 5(フラッシュドライブ) Default : 3 |
3 | |||||||||||||
| InstanceId | 接続するサーバー名 Type : String |
○ | server01 | ||||||||||||
| AccountingType | 利用料金タイプ Type : String 値 : 1(月額課金) | 2(従量課金) Default : 1 |
||||||||||||||
| Description | メモ Type : String |
応答フィールド
| フィールド(項目) | 説明 | サンプル値 |
|---|---|---|
| CreateVolumeResponse | CreateVolume レスポンス Type : CreateVolumeResponseType Ancestor : なし Children : requestId, volumeId, size, diskType, snapshotId, availabilityZone, status, createTime, accountingType |
|
| requestId | リクエスト識別子 Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
ac501097-4c8d-475b-b06b-a90048ec181c |
| volumeId | ディスク名 Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
disk01 |
| size | ディスクサイズ 単位 : GB Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
200 |
| diskType | ディスクタイプ Type : xsd:string 値 : Standard Storage | High-Speed Storage A | High-Speed Storage B | Flash Storage Ancestor : CreateVolumeResponse Children : なし |
High-Speed Storage A |
| snapshotId | ※返却値なし Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
|
| availabilityZone | ゾーン名 Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
east-11 |
| status | 作成ステータス Type : xsd:string 値 : creating (作成中) | available (利用可) Ancestor : CreateVolumeResponse Children : なし |
creating |
| createTime | ディスク作成日時(表示形式:yyyy-mm-ddThh:mi:ss.sssZ) Type : xsd:dateTime Ancestor : CreateVolumeResponse Children : なし |
2010-05-17T11:22:33.456Z |
| accountingType | 利用料金タイプ Type : xsd:string 値 : 1(月額課金) | 2(従量課金) Ancestor : CreateVolumeResponse Children : なし |
|
| description | メモ Type : xsd:string Ancestor : CreateVolumeResponse Children : なし |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?Action=CreateVolume&Size=200&VolumeId=disk01&DiskType=3&InstanceId=server01&accountingType=1&description=Memo&CommonParams 応答サンプル
<CreateVolumeResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<volumeId>disk01</volumeId>
<size>200</size>
<diskType>High-Speed Storage A</diskType>
<snapshotId />
<availabilityZone>east-11</availabilityZone>
<status>creating</status>
<createTime>2008-05-07T11:51:50.000+09:00</createTime>
<accountingType>1</accountingType>
<description>Memo</description>
</CreateVolumeResponse>
