Create a volume#

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

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

HTTPステータスコード#

正常時:202

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

名前 In Type デフォルト値
/必須指定
Description
project_id path string 必須 プロジェクトのUUID
volume body object 必須 volumeオブジェクト
size body integer 必須 ボリュームのサイズ(GB単位)
availability_zone body string 任意 アベイラビリティゾーンの名前
source_volid body string 任意 作成元ボリュームのUUID
作成元と同じサイズの新規ボリュームを作成します。
description body string 任意 ボリュームの説明
snapshot_id body string 任意 既存のスナップショットからボリュームを作成する場合は、スナップショットのUUIDを指定します。新規ボリュームは、スナップショットと同じアベイラビリティゾーンとサイズで作成されます。
backup_id body string 任意 バックアップのUUID
📒注: マイクロバージョン3.47以上を指定してください。
name body string 必須 ボリュームの名前
imageRef body string 任意 ボリュームの作成元となるイメージのUUID
ブート可能なボリュームを作成するには必須です。
volume_type body string None
任意
ボリュームのタイプ
利用可能なタイプについては、機能説明書の「ストレージタイプ」を参照してください。
metadata body object 任意 ボリュームに関連付けられるメタデータのキーと値のペア
consistencygroup_id body string 任意 整合性グループのUUID
整合性グループ機能は現在未サポートのため、「null」を指定してください。
OS-SCH-HNT:scheduler_hints body object 任意 スケジューラに提供するためのデータのリスト

レスポンスボディ(正常系)の説明#

名前 Type Description
migration_status string ボリュームのマイグレーションステータス
attachments array 仮想サーバのアタッチメントの情報
ボリュームが仮想サーバにアタッチされている場合、サーバのUUID、アタッチメントUUID、アタッチされているホスト(ある場合)、機器、機器のUUIDを表示します。仮想サーバがアタッチされていない場合は、空欄です。
links array ボリュームのリンクURL
availability_zone string アベイラビリティゾーンの名前
encrypted boolean 「true」の場合は、ボリュームが暗号化されています。
updated_at string リソースの最新更新日時
日時の入力形式は以下のISO 8601形式です。
CCYY-MM-DDThh:mm:ss±hh:mm
例:2015-08-27T09:49:58-05:00
「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。
replication_status string ボリュームのレプリカ作成のステータス
snapshot_id string 既存のスナップショットからボリュームを作成する場合は、スナップショットのUUIDを指定します。新規ボリュームは、スナップショットと同じアベイラビリティゾーンとサイズで作成されます。
id string ボリュームのUUID
size integer ボリュームのサイズ(GB単位)
user_id string ユーザーのUUID
metadata object ボリュームに関連付けられるメタデータのキーと値のペア
status string ボリュームのステータス
description string ボリュームの説明
multiattach boolean 「true」の場合は、このボリュームは複数の仮想サーバにアタッチすることができます。
source_volid string 作成元ボリュームのUUID
作成元と同じサイズの新規ボリュームを作成します。
volume object volumeオブジェクト
consistencygroup_id string 整合性グループのUUID
name string ボリュームの名前
bootable string ブートの可否を制御します。「true」の場合は、ボリュームから仮想サーバを起動させることができます。
created_at string リソースの作成日時
日時の入力形式は以下のISO 8601形式です。
CCYY-MM-DDThh:mm:ss±hh:mm
例:2015-08-27T09:49:58-05:00
「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合だけ表示されます。
volume_type string 関連付けられているボリュームのタイプ

リクエスト例#

{
    "volume": {
        "size": 10,
        "availability_zone": null,
        "source_volid": null,
        "description": null,
        "multiattach": false,
        "snapshot_id": null,
        "backup_id": null,
        "name": null,
        "imageRef": null,
        "volume_type": null,
        "metadata": {},
        "consistencygroup_id": null
    },
    "OS-SCH-HNT:scheduler_hints": {
        "same_host": [
            "a0cf03a5-d921-4877-bb5c-86d26cf818e1",
            "8c19174f-4220-44f0-824a-cd1eeef10287"
        ]
    }
}

レスポンス例#

{
    "volume": {
        "status": "creating",
        "migration_status": null,
        "user_id": "0eea4eabcf184061a3b6db1e0daaf010",
        "attachments": [],
        "links": [
            {
                "href": "http://23.253.248.171:8776/v3/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
                "rel": "self"
            },
            {
                "href": "http://23.253.248.171:8776/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
                "rel": "bookmark"
            }
        ],
        "availability_zone": "nova",
        "bootable": "false",
        "encrypted": false,
        "created_at": "2015-11-29T03:01:44.000000",
        "description": null,
        "updated_at": null,
        "volume_type": "lvmdriver-1",
        "name": "test-volume-attachments",
        "replication_status": "disabled",
        "consistencygroup_id": null,
        "source_volid": null,
        "snapshot_id": null,
        "multiattach": false,
        "metadata": {},
        "id": "6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
        "size": 2
    }
}