検討中のお客様はこちら

0120-50-6065

10:00〜19:00
土日祝、年末年始除く

お申し込み

ボリューム作成

Description

ブートストレージ もしくは 追加ストレージとしてアタッチするボリュームを作成します。

・ボリューム名には半角英数字と-(ハイフン)の使用が可能です。
・ブートストレージ用のボリュームを作成する際は、imageRefの指定が必要です。
・ボリュームを複製する際は、source_volidを指定します。また、size および volume_typeは
 複製元と同じ値を指定する必要があります。
・ボリュームのsizeに「50」を指定する場合、volume_type は「gpu1-iops-500」のみ指定が
 可能です。
・アタッチされていないsizeが「50」のボリュームは、10個まで作成が可能です。

Request URL

Block Storage 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 Userトークン header トークン発行 にて払い出されたID
tenant_id テナントID URI API情報を確認する にてご確認ください。
name ボリューム名 plain 任意のボリューム名を指定します。
半角英数字と-(ハイフン)の使用が可能です。
size  50
 100
 300
 500
1000
2000
plain ボリュームサイズを指定します。
volume_type ボリュームタイプ名 plain ボリュームタイプ一覧取得 にて対象のボリュームタイプ名をご確認ください。
imageRef (Optional) イメージID plain イメージ一覧取得 にて対象のイメージ名をご確認ください。
description (Optional) ボリューム概要 plain ボリュームに概要を設定したい場合指定します。
source_volid (Optional) 複製元のボリュームID plain 既存のボリュームから複製したい場合に複製元のボリュームIDを指定します。
ボリューム一覧取得 にて対象のボリュームIDをご確認ください。

Response

  • Normal response codes
202

Example

  • Request ※ブートストレージの場合
curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: トークンID" \
-d '{"volume":{"name":"ボリューム名","size":ボリュームサイズ,"volume_type":"ボリュームタイプ名","imageRef":"イメージID"}}' \
https://block-storage.gpu-sys.cloud/v2/テナントID/volumes
  • Response
HTTP/1.1 202 Accepted
Date: Fri, 07 Aug 2020 11:32:16 GMT
Server: Apache
Content-Length: 727
Content-Type: application/json

{
  "volume": {
    "status": "creating",
    "user_id": "ユーザーID",
    "attachments": [],
    "links": [
      {
        "href": "https://block-storage.gpu-sys.cloud/v2/テナントID/volumes/ボリュームID",
        "rel": "self"
      },
      {
        "href": "https://block-storage.gpu-sys.cloud/テナントID/volumes/ボリュームID",
        "rel": "bookmark"
      }
    ],
    "availability_zone": "nova",
    "bootable": "false",
    "encrypted": false,
    "created_at": "2020-08-07T11:33:12.145488",
    "description": null,
    "volume_type": "ボリュームタイプ",
    "name": "ボリューム名",
    "replication_status": "disabled",
    "consistencygroup_id": null,
    "source_volid": null,
    "snapshot_id": null,
    "metadata": {},
    "id": "ボリュームID",
    "size": ボリュームサイズ
  }
}