アーカイブ関連API

GET /archive - アーカイブ一覧を取得
POST /archive - アーカイブを作成
GET /archive/:archiveid - 該当IDのアーカイブ情報を取得
PUT /archive/:archiveid - アーカイブを更新
DELETE /archive/:archiveid - 該当IDのアーカイブを削除
PUT /archive/:archiveid/ftp - アーカイブのFTP共有を開始する
DELETE /archive/:archiveid/ftp - アーカイブのFTP共有を終了し、利用可能な状態にする

GET/archive

アーカイブ一覧を取得

サンプル
- curl

curl

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

POST/archive

アーカイブを作成

サンプル
- リクエスト
- curl

リクエストボディ

// ディスクID:XXXXのアーカイブを作成する例
{
    "Archive":{
        "Name":"ディスクXXXXのアーカイブ",
        "Description":"説明",
        "Zone":{"ID":"XXX"},
        "SourceDisk":{"ID":"XXXX"}
    }
}
// アーカイブID:XXXXを元にアーカイブを作成する例
{
    "Archive":{
        "Name":"アーカイブXXXXのアーカイブ",
        "Description":"説明",
        "Zone":{"ID":"XXX"},
        "SourceArchive":{"ID":"XXXX"}
    }
}
// 20GBの空のアーカイブを作成する例
{
    "Archive":{
        "Name":"20GBの空アーカイブ",
        "Description":"説明",
        "Zone":{"ID":"XXX"},
        "SizeMB": 20480
    }
}

curl

curl --user "Access Token":"Access Token Secret" \
    -X POST \
    -d '{"Archive":{"Name":"New Archive","Zone":{"ID":"XXX"},"SizeMB":20480}}' \
    https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/archive

GET/archive/:archiveid

該当IDのアーカイブ情報を取得

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

レスポンスボディ

{
    "Archive":{
        "ID":"XXXXXXXXXXXX",
        "DisplayOrder":null,
        "Name":"My Archive",
        "Description":"",
        "Scope":"user",
        "Availability":"available",
        "SizeMB":20480,
        "MigratedMB":null,//コピー中のコピー済み容量
        "WaitingJobCount":null,//コピー待ち順番
        "OriginalArchive":{"ID":"XXXXXXXXXXXX"},
        "SourceDiskTemplate":null,//ディスクテンプレートを元に作成した場合にはIDがセットされます
        "ServiceClass":"cloud/archive/20g",
        "CreatedAt":"2012-06-13T10:37:33+09:00",
        "Plan":{
            "ID":2,
            "StorageClass":"iscsi1204",
            "Name":"標準プラン"
        },
        "SourceDisk":null,//ディスクを元に作成した場合にはIDがセットされます
        "SourceDiskSnapshot":null,//スナップショットを元に作成した場合にはIDがセットされます
        "SourceArchive":null,//アーカイブを元に作成した場合にはIDがセットされます
        "Storage":{ /* 省略 */ }
    },
    "is_ok":true
}

curl

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

URLパラメータ

Name	Comment
archiveid	アーカイブID

PUT/archive/:archiveid

アーカイブを更新

サンプル
- リクエスト
- curl

リクエストボディ

{
    "Archive":{
      "Name":"Debian 7.0 Wheezy",
      "Description":"デビアンでいいやん٩(๑˃̌ۿ˂̌๑)۶"
    }
}

curl

# 名前を変更するサンプル
curl --user "Access Token":"Access Token Secret" -X PUT \
     -d '{"Archive":{"Name":"Debian7.0 Wheezy"}}' \
     https://secure.sakura.ad.jp/cloud/api/cloud/zone/is1a/1.1/archive/:archiveid

URLパラメータ

Name	Comment
archiveid	アーカイブID

DELETE/archive/:archiveid

該当IDのアーカイブを削除

サンプル
- curl

curl

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

URLパラメータ

Name	Comment
archiveid	アーカイブID

PUT/archive/:archiveid/ftp

アーカイブのFTP共有を開始する

サンプル
- curl

curl

curl --user "Access Token":"Access Token Secret" -X PUT -d '' \
     https://secure.sakura.ad.jp/cloud/api/cloud/zone/is1a/1.1/archive/:archiveid/ftp

URLパラメータ

Name	Comment
archiveid	アーカイブID

DELETE/archive/:archiveid/ftp

アーカイブのFTP共有を終了し、利用可能な状態にする

サンプル
- curl

curl

curl --user "Access Token":"Access Token Secret" -X DELETE -d '' \
     https://secure.sakura.ad.jp/cloud/api/cloud/zone/is1a/1.1/archive/:archiveid/ftp

URLパラメータ

Name	Comment
archiveid	アーカイブID