ボリューム作成

Description

外部ディスクプランのブートディスク用 もしくは 追加ディスクとしてアタッチするブロックストレージ用のボリュームを作成します。
外部ディスクプランのブートディスクを作成する場合は、「imageRef」パラメーターの指定が必須です。
アタッチされていない50GB-500IOPSのブロックストレージ上限は、10個まで作成が可能です。
ボリューム名には半角英数字と-(ハイフン)の使用が可能です。

Request URL

Block Storage Service API v2

POST v2/{tenant_id}/volumes

Request Json

### ブートディスク用の場合 ###

{
    "volume": {
        "name": "ボリューム名",
        "volume_type": "ボリュームタイプ名",
        "size": "ボリューム容量",
        "imageRef": "イメージID"
    }
}


### 追加ディスク用の場合 ###

{
    "volume": {
        "name": "ボリューム名",
        "volume_type": "ボリュームタイプ名",
        "size": "ボリューム容量"
    }
}


### ボリュームの複製の場合 ###

{
    "volume": {
        "name": "ボリューム名",
        "volume_type": "ボリュームタイプ名",
        "size": "ボリューム容量",
        "source_volid": "複製元のボリュームID"
    }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークンID header トークン発行 にて払い出されたID
tenant_id テナントID URI コントロールパネルにてAPI情報をご確認ください。
name ボリューム名 plain 任意のボリューム名を指定します。
半角英数字と-(ハイフン)の使用が可能です。
size  50
 100
 200
 300
 400
 500
 1000
 2000
plain 任意のディスク容量を指定します。
volume_type ボリュームタイプ名 plain ボリュームタイプ一覧取得 にて対象のボリュームタイプ名をご確認ください。
imageRef(Optional) イメージID URI イメージ一覧取得 にて対象のイメージIDをご確認ください。
source_volid (Optional) 複製元のボリュームID URI ボリューム詳細一覧取得 にて複製元のボリュームIDをご確認ください。
サイズの変更はできません。

Response

  • Normal response codes
202

Example

  • Request ※ブートディスク用の場合
curl -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"volume": {"name": "ボリューム名","volume_type": "ボリュームタイプ名","size": "ボリューム容量","imageRef":"イメージID"}}' \
ボリュームエンドポイント/volumes
  • Response
{
    "volume": {
        "status": "creating",
        "user_id": "ユーザーID",
        "attachments": [],
        "links": [
            {
                "href": "ボリュームエンドポイント/volumes/ボリュームID",
                "rel": "self"
            },
            {
                "href": "https://block-service-r4nd1001.app-sys.jp/テナントID/volumes/ボリュームID",
                "rel": "bookmark"
            }
        ],
        "availability_zone": "nova",
        "bootable": "false",
        "encrypted": false,
        "created_at": "2018-03-30T09:18:39.200116",
        "description": null,
        "volume_type": "ボリュームタイプ名",
        "name": "ディスク名",
        "replication_status": "disabled",
        "consistencygroup_id": null,
        "source_volid": null,
        "snapshot_id": null,
        "metadata": {},
        "id": "ボリュームID",
        "size": ボリューム容量
    }
}

Internet for everyone

Copyright (c) 2024 GMO Internet Group, Inc. All Rights Reserved.