CreateVolume
您可以使用 CreateVolume
方法在集群上创建新的空卷。创建卷后,即可通过 iSCSI 连接该卷。
在未指定 QoS 值的情况下创建的卷将使用默认值。您可以使用 GetDefaultQoS
方法查看卷的默认值。
Parameters
此方法具有以下输入参数:
Name | Description | Type | 默认值 | Required |
---|---|---|---|---|
|
卷的访问模式。如果包括此参数,则唯一支持的值为 |
string |
无 |
否 |
|
拥有此卷的帐户的 ID 。 |
整型 |
无 |
是的。 |
|
将卷与指定的 QoS 策略相关联。可能值:
|
boolean |
true |
否 |
|
名称 - 值对列表,采用 JSON 对象格式。属性总大小必须小于 1000 B 或 1 KB ,包括 JSON 格式化字符。 |
JSON 对象 |
无 |
否 |
|
使用实际IOPS进行负载平衡时、防止卷移动。从Element 12.8开始、此设置可用、并且仅在启用时生效"卷LoadBalanceOn实际IOPS"。可能值:
注意:为实现高可用性(节点故障)而进行的平衡优先于 |
boolean |
false |
否 |
|
启用 512 字节扇区模拟。可能值:
|
boolean |
无 |
是的。 |
|
确定卷是否可用于 SnapMirror 端点的复制。可能值:
|
boolean |
false |
否 |
|
指定卷支持的最大先出( FIFO )快照数。请注意, FIFO 快照和非 FIFO 快照都使用卷上相同的可用快照插槽池。使用此选项可限制可用快照插槽的 FIFO 快照消耗量。如果省略,则默认值为 24 。 |
整型 |
24 |
否 |
|
指定卷预留的最小先出( FIFO )快照插槽数。这样可以保证,如果在卷上同时使用 FIFO 快照和非 FIFO 快照,则非 FIFO 快照不会意外占用过多的 FIFO 插槽。它还可确保至少有如此多的 FIFO 快照始终可用。由于 FIFO 和非 FIFO 快照共享同一个池,因此, |
整型 |
0 |
否 |
|
卷访问组的名称(可以由用户指定)。不需要唯一,但建议使用。长度必须为 1 到 64 个字符。 |
string |
无 |
是的。 |
|
此卷的初始服务质量设置。如果未指定任何值,则使用默认值。可能值:
|
QoS 对象 |
无 |
否 |
|
应将 QoS 设置应用于指定卷的策略的 ID 。此参数与 |
整型 |
无 |
否 |
|
卷的总大小,以字节为单位。大小将向上取整为最接近的 MB 。 |
整型 |
无 |
是的。 |
返回值
此方法具有以下返回值:
Name | Description | Type |
---|---|---|
volume |
包含新创建卷的相关信息的对象。 |
|
volumeId |
新创建卷的卷 ID 。 |
整型 |
曲线 |
此曲线是一组键值对。关键字是以字节为单位的 I/O 大小。这些值表示在特定 I/O 大小下执行 IOP 的成本。此曲线是相对于 100 IOPS 下 4096 字节的操作集计算得出的。 |
JSON 对象 |
请求示例
此方法的请求类似于以下示例:
{ "method": "CreateVolume", "params": { "name": "testit", "accountID": 22, "dontMoveForIopsRebalance": true, "totalSize": 100000000000, "enable512e": false, "attributes": {}, "qos": { "minIOPS": 500, "maxIOPS": 27000, "burstIOPS": 27000, "burstTime": 60 } }, "id": 1 }
响应示例
此方法返回类似于以下示例的响应:
{ "id": 1, "result": { "curve": { "1048576": 15000, "131072": 1950, "16384": 270, "262144": 3900, "32768": 500, "4096": 100, "524288": 7600, "65536": 1000, "8192": 160 }, "volume": { "access": "readWrite", "accountID": 22, "attributes": {}, "blockSize": 4096, "createTime": "2024-04-02T13:03:02Z", "currentProtectionScheme": "doubleHelix", "deleteTime": "", "dontMoveForIopsRebalance": true, "enable512e": false, "enableSnapMirrorReplication": false, "fifoSize": 24, "iqn": "iqn.2010-01.com.solidfire:mysqldata.677", "lastAccessTime": null, "lastAccessTimeIO": null, "minFifoSize": 0, "name": "testit", "previousProtectionScheme": null, "purgeTime": "", "qos": { "burstIOPS": 27000, "burstTime": 60, "curve": { "1048576": 15000, "131072": 1950, "16384": 270, "262144": 3900, "32768": 500, "4096": 100, "524288": 7600, "65536": 1000, "8192": 160 }, "maxIOPS": 27000, "minIOPS": 500 }, "qosPolicyID": null, "scsiEUIDeviceID": "3365657500000140f47acc0100000000", "scsiNAADeviceID": "6f47acc1000000003365657500000140", "sliceCount": 0, "status": "active", "totalSize": 1000000716800, "virtualVolumeID": null, "volumeAccessGroups": [], "volumeConsistencyGroupUUID": "8ed68e57-13ee-47df-8381-29b125142718", "volumeID": 320, "volumePairs": [], "volumeUUID": "e0e2c938-4ecd-4de9-a1be-f6b17c93ce5d" }, "volumeID": 320 } }
自版本以来的新增功能
9.6