ニフクラAPI (コンピューティング: CreateVolume)

CreateVolume

処理概要

ディスクを新規作成します。

サーバーを指定するためには、サーバー名が必要です。

削除済みのサーバーを指定した、管理外のサーバーを指定した、起動中･停止中以外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。 同様に、ディスクサイズおよびディスクタイプに規定外の値を指定した、すでに存在するディスク名を指定した、利用料金タイプに無効な値を指定したなどの場合は、エラーが返されます。

作成したディスクのゾーンは指定したサーバーと同一のゾーンになります。

指定するパラメーター

パラメーター	型	説明	必須
Size	integer	ディスクサイズ 1GB単位と100GB単位の指定ができ、以下の通りとなります。 1GB単位の場合 標準ディスク 100, 200, 300,…, 4000 高速ディスク［A/B］ 100, 200, 300,…, 4000 フラッシュドライブ 100, 200, 300,…, 1000 標準フラッシュドライブ [A/B] 100, 200, 300,…, 4000 高速フラッシュドライブ [A/B] 100, 200, 300,…, 4000 100GB単位の場合 標準ディスク 1, 2, 3,…, 40 高速ディスク［A/B］ 1, 2, 3,…, 40 フラッシュドライブ 1, 2, 3,…, 10 標準フラッシュドライブ [A/B] 1, 2, 3,…, 40 高速フラッシュドライブ [A/B] 1, 2, 3,…, 40 単位: 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	ディスクタイプ 値: 2 (標準ディスク) 3 (高速ディスクA) 4 (高速ディスクB) 5 (フラッシュドライブ) 6 (標準フラッシュドライブA) 7 (標準フラッシュドライブB) 8 (高速フラッシュドライブA) 9 (高速フラッシュドライブB) Default: 3
InstanceId	string	接続するサーバー名	○ (InstanceUniqueId未指定の場合)
InstanceUniqueId	string		○ (InstanceId未指定の場合)
AccountingType	string	利用料金タイプ 値: 1 (月額課金) 2 (従量課金) Default: 1
Description	string	メモ 使用可能文字: 40文字以内※4バイト文字（絵文字や一部の漢字など）は使用できません。

応答フィールド

フィールド (項目)	型	説明
CreateVolumeResponse	-	CreateVolume レスポンス
␣requestId	string	リクエスト識別子
␣volumeId	string	ディスク名
␣volumeUniqueId	string	ディスクユニークID ※空を返却
␣size	integer	ディスクサイズ 単位: GB
␣diskType	string	ディスクタイプ 値: Standard Storage High-Speed Storage A High-Speed Storage B Flash Storage
␣snapshotId	string	※返却値なし
␣availabilityZone	string	ゾーン名
␣status	string	作成ステータス 値: creating (作成中) available (利用可)
␣createTime	timestamp	ディスク作成日時 表示形式:yyyy-mm-ddThh:mi:ss.sss+09:00
␣accountingType	string	利用料金タイプ 値: 1 (月額課金) 2 (従量課金)
␣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>