Upload volume to image#

ボリュームをイメージとしてアップロードします。

📒注: 「/etc/cloud/cloud.cfg」に以下の設定がない場合は、「/etc/cloud/cloud.cfg.d/datasource.cfg」を作成して追加してください。すでに設定済の場合は、対応する必要はありません。 
datasource_list: ['OpenStack']

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://blockstorage.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://blockstorage.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

POST

/v3/{project_id}/volumes/{volume_id}/action

HTTPステータスコード#

正常時：202

エラー時：503

📒注: 「503 Sorry. We're busy for now. Please retry 1 hour later.」が返却された場合は、1時間程度待ってリトライしてください。

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定		 Description
project_id path string 必須 プロジェクトのUUID
volume_id path string 必須 ボリュームのUUID
os-volume_upload_image body object 必須 ボリュームイメージをアップロードするアクション
image_name body string 必須 作成するイメージの名前
force body boolean false
任意		 仮想サーバにアタッチされているボリュームのアップロードの有効性を制御します。
disk_format body string raw
任意		 作成するイメージのディスクフォーマット
以下の値を指定できます。
- qcow2 : qcow2イメージフォーマットを使用する場合(推奨)
- raw : rawイメージフォーマットを使用する場合
container_format body string bare
任意		 作成するイメージのコンテナフォーマット
visibility body string privateまたはshared※
任意		 作成するイメージの公開状況
📒注: 表示するにはマイクロバージョン3.1以上を指定してください。

以下の値を指定できます。
- private : 他のプロジェクトと共有しない場合
- shared : 他のプロジェクトと共有する場合
※ マイクロバージョン3.1以上を指定した場合のデフォルトは「private」、それ以外のデフォルトは「shared」です。
protected body boolean false
任意		 作成するイメージが保護されているかどうかを指定します。
📒注: 表示するにはマイクロバージョン3.1以上を指定してください。

レスポンスボディ（正常系）の説明#

名前 Type Description
os-volume_upload_image object ボリュームイメージをアップロードするアクション
status string ボリュームのステータス
image_name string 作成するイメージの名前
disk_format string 作成するイメージのディスクフォーマット
デフォルトは 「raw」です。
container_format string 作成するイメージのコンテナフォーマット
デフォルトは「bare」です。
visibility string 作成するイメージの公開状況
マイクロバージョン3.1以上を指定した場合のデフォルトは「private」、それ以外のデフォルトは「shared」です。
protected boolean 作成するイメージが保護されているかどうかを指定します。デフォルトは「false」です。
updated_at string リソースの最新更新日時
日時の入力形式は以下のISO 8601形式です。
CCYY-MM-DDThh:mm:ss±hh:mm
例：2015-08-27T09:49:58-05:00
「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。
image_id string 作成するイメージのUUID
display_description string ボリュームの説明
id string ボリュームのUUID
size integer ボリュームのサイズ(GB単位）
volume_type string 関連付けられているボリュームのタイプ

リクエスト例#

{
  "os-volume_upload_image":{
    "image_name": "test",
    "force": false,
    "disk_format": "qcow2",
    "container_format": "bare",
    "visibility": "private",
    "protected": false
  }
}

レスポンス例#

{
  "os-volume_upload_image": {
    "status": "uploading",
    "container_format": "bare",
    "image_name": "test",
    "visibility": "private",
    "updated_at": "2017-06-05T08:44:28.000000",
    "image_id": "de75b74e-7f0d-4b59-a263-bd87bfc313bd",
    "display_description": null,
    "id": "3a81fdac-e8ae-4e61-b6a2-2e14ff316f19",
    "size": 1,
    "disk_format": "qcow2",
    "volume_type": null,
    "protected": false
  }
}