######################################################################
# All Rights Reserved, Copyright FUJITSU LIMITED 2015-2018
#
# API実行サンプル名:
# 03-004_ブロックストレージ作成
#
# 内容:
# ブロックストレージを作成する手順です。
#
#                                                 版数：v1.1
#                                                 更新日：2018/1/26
######################################################################


手順：
───────────────────────────────────
  項番１．ブロックストレージ作成
  項番２．ブロックストレージ確認
───────────────────────────────────


注意事項：
  ・仮想サーバのシステムストレージとして使用する場合は、ハイパフォー
    マンスタイプのストレージを指定しないでください。ハイパフォーマンス
    タイプのストレージを仮想サーバのシステムストレージとして使用した
    場合は、仮想サーバ作成の遅延や、仮想サーバイメージ作成に失敗する
    可能性があります。
  ・作成したブロックストレージを仮想サーバ作成時に使用する手順に
    ついては、API実行サンプル「仮想サーバ作成【DHCP取得_ストレージ
    指定】」を参照してください。



項番１．ブロックストレージ作成
  ブロックストレージを作成します。


  環境定義コマンド例：
======================================================================
# VOLUME_NAME=<作成するブロックストレージ名>
VOLUME_NAME=TEST_STORAGE_01

# SIZE=<作成するブロックストレージサイズ(GB)>
SIZE=10

# VOLUME_TYPE=<ストレージタイプ("M1","H2"を指定)>
VOLUME_TYPE=M1

# AZ=<アベイラビリティゾーン名>
AZ=jp-west-2a


  API実行コマンド例：
======================================================================
curl -Ss $BLOCKSTORAGE/v2/$PROJECT_ID/volumes -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/json" -d '{"volume":{"name": "'$VOLUME_NAME'", "size": "'$SIZE'", "volume_type": "'$VOLUME_TYPE'", "availability_zone": "'$AZ'"}}' | jq .


  レスポンス例：
======================================================================
{
  "volume": {
    "size": 10,
    "id": "eefd9954-0b8e-49a0-be0d-acc435f1n4u9",
    "metadata": {
      "readonly": "False"
    },
    "snapshot_id": null,
    "source_volid": null,
    "name": "TEST_STORAGE_01",
    "volume_type": "M1",
    "description": null,
    "status": "creating",
    "user_id": "<ユーザーID>",
    "attachments": [],
    "links": [
      {
        "rel": "self",
        "href": "http://10.27.0.201/v2/<プロジェクトID>/volumes/eefd9954-0b8e-49a0-be0d-acc435f1n4u9"
      },
      {
        "rel": "bookmark",
        "href": "http://10.27.0.201/<プロジェクトID>/volumes/eefd9954-0b8e-49a0-be0d-acc435f1n4u9"
      }
    ],
    "availability_zone": "jp-west-2a",
    "bootable": "false",
    "encrypted": false,
    "created_at": "2017-12-27T02:46:11.558717"
  }
}
======================================================================



項番２．ブロックストレージ確認
  ブロックストレージが作成されたことを以下のパラメータで確認します。
  ・"status": "available"


  環境定義コマンド例：
======================================================================
# VOLUME_ID=<作成したブロックストレージのID>
VOLUME_ID=eefd9954-0b8e-49a0-be0d-acc435f1n4u9


  API実行コマンド例：
======================================================================
curl -Ss $BLOCKSTORAGE/v2/$PROJECT_ID/volumes/$VOLUME_ID -X GET -H "X-Auth-Token:$OS_AUTH_TOKEN" -H "Content-Type:application/json" | jq .


  レスポンス例：
======================================================================
{
  "volume": {
    "size": 10,
    "os-vol-mig-status-attr:migstat": null,
    "id": "eefd9954-0b8e-49a0-be0d-acc435f1n4u9",
    "metadata": {
      "readonly": "False"
    },
    "created_at": "2017-12-27T02:46:11.000000",
    "encrypted": false,
    "bootable": "false",
    "availability_zone": "jp-west-2a",
    "links": [
      {
        "rel": "self",
        "href": "http://10.27.0.201/v2/<プロジェクトID>/volumes/eefd9954-0b8e-49a0-be0d-acc435f1n4u9"
      },
      {
        "rel": "bookmark",
        "href": "http://10.27.0.201/<プロジェクトID>/volumes/eefd9954-0b8e-49a0-be0d-acc435f1n4u9"
      }
    ],
    "attachments": [],
    "user_id": "<ユーザID>",
    "status": "available",
    "description": null,
    "os-vol-tenant-attr:tenant_id": "<プロジェクトID>",
    "volume_type": "M1",
    "name": "TEST_STORAGE_01",
    "os-vol-host-attr:host": "ror-cinder@M1_28",
    "source_volid": null,
    "snapshot_id": null,
    "os-vol-mig-status-attr:name_id": null
  }
}
======================================================================



変更履歴：
───────────────────────────────────
v1.1版：
  ・「注意事項」：説明追記
  ・「項番１．ブロックストレージ作成」：環境変数追記、説明追記
  ・「項番２．ブロックストレージ確認」：説明追記
───────────────────────────────────



以上