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
    }
}