ログイン

ボリューム追加

Description

ボリュームを作成します。

Request URL

Volume API

POST /v2/{tenant_id}/volumes

Request Json

・新規作成の場合

{
  "volume": {
    "size": サイズ,
    "name": "ボリューム名",
    "metadata": {}
  }
}

・各種ソース

{
  "volume": {
    "source_volid": "複製元のボリュームID",
    "description": "概要",
    "snapshot_id": null,
    "size": サイズ,
    "name": "ボリューム名",
    "imageRef": "イメージID",
    "metadata": {}
  }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークンID header トークンIDを指定します。
Content-Type application/json header データの形式(メディアタイプ)を指定します。
tenant_id テナントID path テナントIDを指定します。
size 200
500		 body 任意のボリューム容量を指定します。
name ボリューム名 body 任意のボリュームの名前を指定します。
使用可能な文字列は、半角英数字、「-(ハイフン)」、「_(アンダーバー)」のみ。文字数の上限は、255文字になります。
description
(Optional)		 概要 body 任意の概要(説明)を指定します。
imageRef
(Optional)		 イメージID body イメージIDを指定します。
保存したイメージから作成したい場合に使用します。
source_volid
(Optional)		 ボリュームID body 複製元のボリュームIDを指定します。
既存のボリュームから複製したい場合に使用します。
metadata
(Optional)		 メタデータ body ボリュームのメタデータを指定します。

Response Code

Success 

202

Example

Request 

curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"volume":{"size":サイズ,"name":"ボリューム名", "metadata":{}}}' \
https://block-storage.tyo1.conoha.io/v2/テナントID/volumes

Response 

HTTP/1.1 202 Accepted
Date: Thu, 11 Dec 2014 11:17:52 GMT
Server: Apache
Content-Length: 820
Content-Type: application/json

{
    "volume": {
        "attachments": [],
        "availability_zone": "nova",
        "bootable": "false",
        "consistencygroup_id": null,
        "created_at": "2015-05-08T09:17:04.365238",
        "description": null,
        "encrypted": false,
        "id": "40e84769-f99a-4d7f-8594-4d0db87bc7e4",
        "links": [
            {
                "href": "https://block-storage.tyo1.conoha.io/v2/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
                "rel": "self"
            },
            {
                "href": "https://block-storage.tyo1.conoha.io/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
                "rel": "bookmark"
            }
        ],
        "metadata": {},
        "name": "gmo-vol",
        "replication_status": "disabled",
        "size": 200,
        "snapshot_id": null,
        "source_volid": null,
        "status": "creating",
        "user_id": "ea63fc7a16bb4250aff7e203198eea22",
        "volume_type": "SAMPLE_VOLUME_TYPE"
    }
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。