CreateVolume

CreateVolumeメソッドを使用すると、クラスタに新しい空のボリュームを作成できます。作成したボリュームはすぐにiSCSI経由で接続できます。

QoS値を指定せずに作成したボリュームには、デフォルト値が使用されます。GetDefaultQoSメソッドを使用すると、ボリュームのデフォルト値を表示できます。

パラメータ

このメソッドの入力パラメータは次のとおりです。

名前 説明 タイプ デフォルト値 必須
accountID このボリュームを所有するアカウントのID。 整数 なし
associateWithQoSPolicy 指定したQoSポリシーにボリュームを関連付けます。有効な値は次のとおりです。
  • trueQoSPolicyIDパラメータで指定したQoSポリシーにボリュームが関連付けられます。
  • falseQoSPolicyIDパラメータで指定したQoSポリシーにボリュームが関連付けられません。falseの場合、QoSPolicyパラメータでQoSポリシーを指定したかどうかに関係なく、既存のポリシーの関連付けが削除されます。
ブーリアン true ×
attributes JSONオブジェクト形式の名前と値のペアのリスト。JSONの書式指定文字を含め、1,000B(1KB)未満で指定する必要があります。 JSONオブジェクト なし ×
enable512e 512バイトのセクター エミュレーションを有効にします。有効な値は次のとおりです。
  • true:ボリュームは512バイトのセクター エミュレーションを提供します。
  • false:512eエミュレーションは有効になりません。
ブーリアン なし
enableSnapMirrorReplication ボリュームをSnapMirrorエンドポイントでのレプリケーションに使用できるかどうかを決定します。有効な値は次のとおりです。
  • true
  • false
ブーリアン false ×
name ボリューム アクセス グループの名前(ユーザが指定可能)。一意である必要はありませんが、一意にすることを推奨します。1~64文字で指定します。 文字列 なし
qos このボリュームの初期QoS設定。指定しない場合、デフォルト値が使用されます。有効な値は次のとおりです。
  • minIOPS
  • maxIOPS
  • burstIOPS
QoSオブジェクト なし ×
qosPolicyID 指定したボリュームに適用するQoS設定が定義されたポリシーのID。このパラメータは、qosパラメータと同時に指定することはできません。 整数 なし ×
totalSize ボリュームの合計サイズ(バイト)。サイズは最も近いMB単位に切り上げられます。 整数 なし

戻り値

このメソッドの戻り値は次のとおりです。

名前 説明 タイプ
volume 作成されたボリュームの情報を含むオブジェクト。 volume
volumeID 作成されたボリュームのID。 整数
curve curveは一連のキーと値のペアです。キーはI/Oサイズ(バイト)です。値は特定のI/OサイズでIOPを実行する際のコストを表します。curveは、100 IOPSでの4,096バイトの処理セットと比較して計算されます。 JSONオブジェクト

要求例

このメソッドの要求例を次に示します。

{
   "method": "CreateVolume",
   "params": {
      "name": "mysqldata",
      "accountID": 1,
      "totalSize": 107374182400,
      "enable512e": false,
      "attributes": {
         "name1": "value1",
         "name2": "value2",
         "name3": "value3"
      },
      "qos": {
         "minIOPS": 50,
         "maxIOPS": 500,
         "burstIOPS": 1500,
         "burstTime": 60
      }
   },
   "id": 1
}

応答例

このメソッドの応答例を次に示します。

{
    "id": 1,
    "result": {
        "curve": {
            "4096": 100,
            "8192": 160,
            "16384": 270,
            "32768": 500,
            "65536": 1000,
            "131072": 1950,
            "262144": 3900,
            "524288": 7600,
            "1048576": 15000
        },
        "volume": {
            "access": "readWrite",
            "accountID": 1,
            "attributes": {
                "name1": "value1",
                "name2": "value2",
                "name3": "value3"
            },
            "blockSize": 4096,
            "createTime": "2016-03-31T22:20:22Z",
            "deleteTime": "",
            "enable512e": false,
            "iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
            "name": "mysqldata",
            "purgeTime": "",
            "qos": {
                "burstIOPS": 1500,
                "burstTime": 60,
                "curve": {
                    "4096": 100,
                    "8192": 160,
                    "16384": 270,
                    "32768": 500,
                    "65536": 1000,
                    "131072": 1950,
                    "262144": 3900,
                    "524288": 7600,
                    "1048576": 15000
                },
                "maxIOPS": 500,
                "minIOPS": 50
            },
            "scsiEUIDeviceID": "6a796179000002a5f47acc0100000000",
            "scsiNAADeviceID": "6f47acc1000000006a796179000002a5",
            "sliceCount": 0,
            "status": "active",
            "totalSize": 107374182400,
            "virtualVolumeID": null,
            "volumeAccessGroups": [],
            "volumeID": 677,
            "volumePairs": []
        },
        "volumeID": 677
    }
}

新規導入バージョン

9.6