アーカイブ関連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/:archiveid/tag

-

該当IDのアーカイブに付けられたタグを取得
PUT

/archive/:archiveid/tag

-

該当IDのアーカイブに付けられるタグを変更
POST

/archive/:archiveid/to/zone/:zoneid

-

アーカイブを他のゾーンに転送
GET

/archive/tag

-

アーカイブタグ一覧を取得

GET/archive

アーカイブ一覧を取得

サンプル
- curl(Linux)
- curl(Windows)

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

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

POST/archive

アーカイブを作成

サンプル

// ディスクID:XXXXのアーカイブを作成する例
{
  "Archive":{
    "Name":"ディスクXXXXのアーカイブ",
    "Description":"説明",
    "SourceDisk":{"ID":"XXXX"}
  }
}

// アーカイブID:XXXXを元にアーカイブを作成する例
{
  "Archive":{
    "Name":"アーカイブXXXXのアーカイブ",
    "Description":"説明",
    "SourceArchive":{"ID":"XXXX"}
  }
}

// 20GBの空のアーカイブを作成する例
{
  "Archive":{
    "Name":"20GBの空アーカイブ",
    "Description":"説明",
    "SizeMB": 20480
  }
}

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

curl -k --user "Access Token":"Access Token Secret" ^
    -X POST ^
    -d "{\"Archive\":{\"Name\":\"New Archive\",\"SizeMB\":20480}}" ^
    -H "Content-type: application/json" ^
https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/archive

GET/archive/:archiveid

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

サンプル

{
  "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 --user "Access Token":"Access Token Secret" \
    https://secure.sakura.ad.jp/cloud/zone/is1a/api/cloud/1.1/archive/:archiveid

curl -k --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

アーカイブを更新

サンプル

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

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

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

URLパラメータ

Name	Comment
archiveid	アーカイブID

DELETE/archive/:archiveid

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

サンプル
- curl(Linux)
- curl(Windows)

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

curl -k --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(Linux)
- curl(Windows)

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

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

URLパラメータ

Name	Comment
archiveid	アーカイブID

DELETE/archive/:archiveid/ftp

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

サンプル
- curl(Linux)
- curl(Windows)

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

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

URLパラメータ

Name	Comment
archiveid	アーカイブID

GET/archive/:archiveid/tag

該当IDのアーカイブに付けられたタグを取得

PUT/archive/:archiveid/tag

該当IDのアーカイブに付けられるタグを変更

POST/archive/:archiveid/to/zone/:zoneid

アーカイブを他のゾーンに転送

URLパラメータ

Name	Comment
archiveid	アーカイブID
zoneid	ゾーンID

GET/archive/tag

アーカイブタグ一覧を取得