本文へジャンプします。

ニフティクラウド APIリファレンス

CreateVolume

処理概要

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

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

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

指定するパラメーター

パラメーター 説明 必須 サンプル値
Size

ディスクサイズ
単位 : 1GB | 100GB
Type : String
値 : 1GB単位と100GB単位の指定ができ、以下の通りとなります。

1GB単位の場合

標準ディスク 100, 200, 300,…, 1000
高速ディスク[A/B] 100, 200, 300,…, 1000
フラッシュドライブ 100, 200, 300,…, 500

100GB単位の場合

標準ディスク 1, 2, 3,…, 10
高速ディスク[A/B] 1, 2, 3,…, 10
フラッシュドライブ 1, 2, 3,…, 5
2
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 : なし
f6dd8353-eb6b-6b4fd32e4f05
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://cp.cloud.nifty.com/api/?Action=CreateVolume&Size=2&VolumeId=disk01&DiskType=3&InstanceId=server01&accountingType=1&description=Memo&CommonParams

応答サンプル

<CreateVolumeResponse xmlns="https://cp.cloud.nifty.com/api/">
  <requestId>f6dd8353-eb6b-6b4fd32e4f05</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.000Z</createTime>
  <accountingType>1</accountingType>
  <description>Memo</description>
</CreateVolumeResponse>

ニフティクラウド サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフティクラウド公式フェイスブックページ

推奨画面サイズ 1024×768 以上