您可以使用 CreateVolume 方法在集群上创建新的空卷。创建完卷后,即可通过 iSCSI 连接该卷。
如果在创建卷时未指定 QoS 值,则该卷将使用默认值。您可以使用 GetDefaultQoS 方法来查看卷的默认值。
此方法具有以下输入参数:
名称 | 说明 | 类型 | 默认值 | 必需 |
---|---|---|---|---|
accountID | 拥有此卷的帐户的 ID。 | 整型 | 无 | 是 |
associateWithQoSPolicy | 将卷与指定的 QoS 策略相关联。可能值:
|
布尔型 | true | 否 |
attributes | 名称-值对的列表,采用 JSON 对象格式。属性总大小必须小于 1000 B 或 1 KB,包括 JSON 格式的字符。 | JSON 对象 | 无 | 否 |
enable512e | 启用 512 字节的扇区模拟。可能值:
|
布尔型 | 无 | 是 |
enableSnapMirrorReplication | 确定卷是否可用于 SnapMirror 端点的复制。可能值:
|
布尔型 | false | 否 |
name | 卷访问组的名称(可由用户指定)。此名称不必唯一,但建议使用唯一名称。长度必须是 1 到 64 个字符。 | 字符串 | 无 | 是 |
qos | 该卷的初始服务质量设置。如果未指定,将使用默认值。可能值:
|
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