Create a snapshot#

スナップショットを作成します。

📒注: 「/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}/snapshots

HTTPステータスコード#

正常時：202

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

名前 In Type デフォルト値
/必須指定		 Description
project_id path string 必須 プロジェクトのUUID
snapshot body object 必須 スナップショットオブジェクト
volume_id body string 必須 ボリュームのUUID
name body string 必須 スナップショットの名前
description body string None
任意		 スナップショットの説明
force body boolean false
任意		 ボリュームがアタッチしている場合でも強制的にバックアップを行うかどうかを指定します。
metadata body object 任意 スナップショットのメタデータのキーと値のペア

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

名前 Type Description
status string スナップショットのステータス
description string スナップショットの説明
created_at string リソースの作成日時
日時の入力形式は以下のISO 8601形式です。
CCYY-MM-DDThh:mm:ss±hh:mm
例：2015-08-27T09:49:58-05:00
「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。
name string スナップショットの名前
snapshot object スナップショットオブジェクト
user_id string ユーザーのUUID
📒注: 表示するにはマイクロバージョン3.41以上を指定してください。
volume_id string ボリュームのUUID
metadata object スナップショットのメタデータのキーと値のペア
id string スナップショットのUUID
size integer ボリュームのサイズ(GB単位）
updated_at string リソースの最新更新日時
日時の入力形式は以下のISO 8601形式です。
CCYY-MM-DDThh:mm:ss±hh:mm
例：2015-08-27T09:49:58-05:00
「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。

リクエスト例#

{
    "snapshot": {
        "name": "snap-001",
        "description": "Daily backup",
        "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
        "force": true,
        "metadata": null
    }
}

レスポンス例#

{
    "snapshot": {
        "status": "creating",
        "description": "Daily backup",
        "created_at": "2013-02-25T03:56:53.081642",
        "metadata": {},
        "updated_at": "2013-02-25T03:58:53.081642",
        "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
        "size": 1,
        "user_id": "40c2102f4a554b848d96b14f3eec39ed",
        "id": "ffa9bc5e-1172-4021-acaf-cdcd78a9584d",
        "name": "snap-001"
    }
}