CreateVolume

您可以使用 CreateVolume 方法在集群上创建新的空卷。创建完卷后，即可通过 iSCSI 连接该卷。

如果在创建卷时未指定 QoS 值，则该卷将使用默认值。您可以使用 GetDefaultQoS 方法来查看卷的默认值。

参数

此方法具有以下输入参数：

名称	说明	类型	默认值	必需
accountID	拥有此卷的帐户的 ID。	整型	无	是
associateWithQoSPolicy	将卷与指定的 QoS 策略相关联。可能值： true：将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。 false：不将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。如果为 false，无论是否在 QoSPolicy 参数中指定 QoS 策略，都将删除任何现有的策略关联。	布尔型	true	否
attributes	名称-值对的列表，采用 JSON 对象格式。属性总大小必须小于 1000 B 或 1 KB，包括 JSON 格式的字符。	JSON 对象	无	否
enable512e	启用 512 字节的扇区模拟。可能值： true：卷提供 512 字节的扇区模拟。 false：不启用 512e 模拟。	布尔型	无	是
enableSnapMirrorReplication	确定卷是否可用于 SnapMirror 端点的复制。可能值： true false	布尔型	false	否
name	卷访问组的名称（可由用户指定）。此名称不必唯一，但建议使用唯一名称。长度必须是 1 到 64 个字符。	字符串	无	是
qos	该卷的初始服务质量设置。如果未指定，将使用默认值。可能值： minIOPS maxIOPS burstIOPS	QoS 对象	无	否
qosPolicyID	策略 ID，该策略中的 QoS 设置应该应用于指定卷。此参数与 qos 参数不能同时使用。	整型	无	否
totalSize	卷的总大小（以字节为单位）。大小将向上取整为最接近的 MB。	整型	无	是

返回值

此方法具有以下返回值：

名称	说明	类型
volume	包含新创建卷的相关信息的对象。	volume
volumeID	新建卷的卷 ID。	整型
curve	此曲线是一组键-值对。这些键表示 I/O 大小（以字节为单位）。这些值表示在特定 I/O 大小情形下执行 IOP 的成本。此曲线相对于 100 IOPS 处的 4096 字节操作集计算而得。	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