CreateVolume
処理概要
ディスクを新規作成します。
サーバーを指定するためには、サーバー名が必要です。
削除済みのサーバーを指定した、管理外のサーバーを指定した、起動中･停止中以外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。 同様に、ディスクサイズおよびディスクタイプに規定外の値を指定した、すでに存在するディスク名を指定した、利用料金タイプに無効な値を指定したなどの場合は、エラーが返されます。
作成したディスクのゾーンは指定したサーバーと同一のゾーンになります。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Size | integer |
ディスクサイズ
単位: GB 値:
|
○ | ||||||||||||||||||||
| VolumeId | string |
ディスク名 Default: 半角英数8文字 (システム発行) 使用可能文字: 半角英数（32文字） |
|||||||||||||||||||||
| DiskType | string |
ディスクタイプ 値:
|
|||||||||||||||||||||
| InstanceId | string |
接続するサーバー名 |
○ (InstanceUniqueId未指定の場合) | ||||||||||||||||||||
| InstanceUniqueId | string |
|
○ (InstanceId未指定の場合) | ||||||||||||||||||||
| AccountingType | string |
利用料金タイプ 値:
|
|||||||||||||||||||||
| Description | string |
メモ 使用可能文字: 全半角数字（40文字） |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| CreateVolumeResponse | - |
CreateVolume レスポンス Ancestor: なし Children: requestId | volumeId | size | diskType | snapshotId | availabilityZone | status | createTime | accountingType | description |
| requestId | string |
リクエスト識別子 Ancestor: CreateVolumeResponse Children: なし |
| volumeId | string |
ディスク名 Ancestor: CreateVolumeResponse Children: なし |
| size | integer |
ディスクサイズ 単位: GB Ancestor: CreateVolumeResponse Children: なし |
| diskType | string |
ディスクタイプ 値:
Children: なし |
| snapshotId | string |
※返却値なし Ancestor: CreateVolumeResponse Children: なし |
| availabilityZone | string |
ゾーン名 Ancestor: CreateVolumeResponse Children: なし |
| status | string |
作成ステータス 値:
Children: なし |
| createTime | timestamp |
ディスク作成日時 表示形式:yyyy-mm-ddThh:mi:ss.sss+09:00 Ancestor: CreateVolumeResponse Children: なし |
| accountingType | string |
利用料金タイプ 値:
Children: なし |
| description | string |
メモ Ancestor: CreateVolumeResponse Children: なし |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?
Action=CreateVolume
&Size=200
&VolumeId=disk01
&DiskType=6
&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>Standard Flash Storage A</diskType>
<snapshotId/>
<availabilityZone>east-11</availabilityZone>
<status>creating</status>
<createTime>2020-07-10T16:47:39.366+09:00</createTime>
<accountingType>1</accountingType>
<description>Memo</description>
</CreateVolumeResponse>
