ISOイメージ関連API

GET /cdrom - CD-ROM一覧を取得
POST /cdrom - CD-ROMを作成
GET /cdrom/:cdromid - 該当IDのCD-ROM情報を取得
PUT /cdrom/:cdromid - CD-ROMを更新
DELETE /cdrom/:cdromid - 該当IDのCD-ROMを削除
PUT /cdrom/:cdromid/ftp - CD-ROMイメージのFTP共有を開始する
DELETE /cdrom/:cdromid/ftp - CD-ROMイメージのFTP共有を終了し、利用可能な状態にする
GET /region/:regionid/cdrom - リージョン内のCD-ROM一覧を取得
GET /zone/:zoneid/cdrom - ゾーン内のCD-ROM一覧を取得

GET/cdrom

CD-ROM一覧を取得

サンプル
- レスポンス
- curl

レスポンスボディ

{
  "From":0,
  "Count":1,
  "Total":1,
  "CDROMs":[
    {
    "Index":0,
    "ID":XXXXXXXXXXXX,
    "DisplayOrder":XXXXXXXXXXXX,
    "StorageClass":"nfs1109",
    "Name":"CentOS 6.3 64bit(1/2)",
    "Description":"CentOS-6.3-i386-bin-DVD-1of2",
    "SizeMB":5120,
    "Scope":"shared",
    "Availability":"available",
    "ServiceClass":null,
    "CreatedAt":"2012-05-22T11:23:22+09:00"
    }
  ]
}

curl

curl --user "Access Token":"Access Token Secret" \
    https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/cdrom

POST/cdrom

CD-ROMを作成

サンプル
- レスポンス

レスポンスボディ

{
    "CDROM": {
        "ID": "**********",
        "DisplayOrder": null,
        "StorageClass": "XXXXXX",
        "Name": "Debian Wheezy",
        "Description": "Debian 7",
        "SizeMB": "5120",
        "Scope": "user",
        "Availability": "uploading",
        "ServiceClass": "cloud/iso/5g",
        "CreatedAt": "2013-05-16T13:56:37+09:00"
    },
    "FTPServer": {
        "HostName": "xxxxxxxxx",
        "IPAddress": "xxx.xxx.xxx.xxx",
        "User": "user",
        "Password": "*********"
    },
    "Success": true,
    "is_ok": true
}

パラメータ

名前	型	省略	説明
[CDROM.Storage.ID]	int	可	ストレージを指定するとき、そのID
CDROM.SizeMB	int	不可	アップロード予定のイメージファイルのサイズをMB単位で指定

オブジェクト構造

アクセス				キー	バリデーション
読取	検索	書込	更新	キー	必須	デフォルト	範囲
○	○			ID : int
○	○			DisplayOrder : int
○	○	○		StorageClass : EStorageClass		nfs1109
○	○	○	○	Name : string	○		1~64文字
○		○	○	Description : string		空文字	512文字
○	○	○		SizeMB : int	○
○	○			Scope : EScope
○	○			Availability : EAvailability
○				ServiceClass : string

GET/cdrom/:cdromid

該当IDのCD-ROM情報を取得

サンプル
- curl

curl

curl --user "Access Token":"Access Token Secret" \
    https://secure.sakura.ad.jp/cloud/api/cloud/1.0/cdrom/:cdromid

URLパラメータ

Name	Comment
cdromid	CD-ROM ID

PUT/cdrom/:cdromid

CD-ROMを更新

URLパラメータ

Name	Comment
cdromid	CD-ROM ID

DELETE/cdrom/:cdromid

該当IDのCD-ROMを削除

URLパラメータ

Name	Comment
cdromid	CD-ROM ID

PUT/cdrom/:cdromid/ftp

CD-ROMイメージのFTP共有を開始する

サンプル
- レスポンス
- curl

レスポンスボディ

{
    "FTPServer": {
          "HostName": "xxxxxxxxxxxxxx",
          "IPAddress": "XXX.XXX.XXX.XXX",
          "User": "user",
          "Password": "password"
    }
}

curl

# FTP共有を開始する
curl --user "Access Token":"Access Token Secret" -X PUT -d '' \
    https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/cdrom/:cdromid/ftp
# ftpsでローカルのISOファイルをアップロードする例
curl --ssl -u user:password -T /path/to/iso_file ftp://hogehoge.sakura.ad.jp

URLパラメータ

Name	Comment
cdromid	CD-ROM ID

パラメータ

名前	型	省略	説明
ChangePassword	boolean	不可	パスワードの変更時はtrue

DELETE/cdrom/:cdromid/ftp

CD-ROMイメージのFTP共有を終了し、利用可能な状態にする

サンプル
- curl

curl

# FTP共有を終了し、利用可能な状態にする例
curl --user "Access Token":"Access Token Secret" -X DELETE \
    https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/cdrom/:cdromid/ftp

URLパラメータ

Name	Comment
cdromid	CD-ROM ID

GET/region/:regionid/cdrom

リージョン内のCD-ROM一覧を取得

GET/zone/:zoneid/cdrom

ゾーン内のCD-ROM一覧を取得