CreateVolume
建议更改
PDF
您可以使用 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