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>