CreateVolume
処理概要
ディスクを新規作成します。
サーバーを指定するためには、サーバー名が必要です。
削除済みのサーバーを指定した、管理外のサーバーを指定した、起動中・停止中以外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。 同様に、ディスクサイズおよびディスクタイプに規定外の値を指定した、すでに存在するディスク名を指定した、利用料金タイプに無効な値を指定したなどの場合は、エラーが返されます。
作成したディスクのゾーンは指定したサーバーと同一のゾーンになります。
指定するパラメーター
パラメーター | 型 | 説明 | 必須 | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Size | integer |
ディスクサイズ
単位: GB 使用可能文字: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40(100GB単位指定) 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900, 2000, 2100, 2200, 2300, 2400, 2500, 2600, 2700, 2800, 2900, 3000, 3100, 3200, 3300, 3400, 3500, 3600, 3700, 3800, 3900, 4000(1GB単位指定) |
○ | ||||||||||||||||||||
VolumeId | string |
ディスク名 Default: 半角英数8文字 (システム発行) 使用可能文字: 半角英数(32文字) |
|||||||||||||||||||||
DiskType | string |
ディスクタイプ 値:
|
|||||||||||||||||||||
InstanceId | string |
接続するサーバー名 |
○ (InstanceUniqueId未指定の場合) | ||||||||||||||||||||
InstanceUniqueId | string |
|
○ (InstanceId未指定の場合) | ||||||||||||||||||||
AccountingType | string |
利用料金タイプ 値:
|
|||||||||||||||||||||
Description | string |
メモ 使用可能文字: 40文字以内※4バイト文字(絵文字や一部の漢字など)は使用できません。 |
応答フィールド
フィールド (項目) | 型 | 説明 |
---|---|---|
CreateVolumeResponse | - |
CreateVolume レスポンス |
␣requestId | string |
リクエスト識別子 |
␣volumeId | string |
ディスク名 |
␣volumeUniqueId | string |
ディスクユニークID ※空を返却 |
␣size | integer |
ディスクサイズ 単位: GB |
␣diskType | string |
ディスクタイプ 値:
|
␣snapshotId | string |
※返却値なし |
␣availabilityZone | string |
ゾーン名 |
␣status | string |
作成ステータス 値:
|
␣createTime | timestamp |
ディスク作成日時 表示形式:yyyy-mm-ddThh:mi:ss.sss+09:00 |
␣accountingType | string |
利用料金タイプ 値:
|
␣description | string |
メモ |
リクエストサンプル
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>
<volumeUniqueId/>
<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>