简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。
ListVolumes
贡献者
建议更改
您可以使用 ListVolumes
方法获取集群中的卷列表。您可以使用可用参数指定要在列表中返回的卷。
Parameters
此方法具有以下输入参数:
Name | Description | Type | 默认值 | Required |
---|---|---|---|---|
—帐户 |
仅返回由此处指定的帐户拥有的卷。与 volumeIDs 参数不能共存。 |
整型数组 |
无 |
否 |
包括 VirtualVolumes |
默认情况下,响应中包含虚拟卷。要排除虚拟卷,请设置为 false 。 |
boolean |
true |
否 |
已完成 |
返回已配对或未配对的卷。可能值:
|
boolean |
无 |
否 |
limit |
用于设置返回的卷结果的最大数量。与 volumeIDs 参数不能共存。 |
整型 |
10000 |
否 |
startVolumeID |
仅返回 ID 大于或等于此值的卷。与 volumeIDs 参数不能共存。 |
整型 |
无 |
否 |
volumeIds |
卷 ID 列表。如果指定此参数,则其他参数仅对这组卷运行。与 accounts , startVolumeID 和 limit 参数互斥。 |
整型数组 |
否 |
否 |
volumeName |
仅返回与卷名称匹配的卷对象信息。 |
string |
否 |
否 |
卷状态 |
仅返回状态等于状态值的卷。可能值:
|
string |
否 |
否 |
返回值
此方法具有以下返回值:
Name |
Description |
Type |
volumes |
卷列表。 |
volume 数组 |
请求示例
此方法的请求类似于以下示例:
{ "method": "ListVolumes", "params": { "volumeIDs": [1], "volumeStatus": "active", "isPaired": "false" }, "id": 1 }
响应示例
此方法返回类似于以下示例的响应:
{ "id": 1, "result": { "volumes": [ { "access": "readWrite", "accountID": 1, "attributes": {}, "blockSize": 4096, "createTime": "2016-03-28T14:39:05Z", "deleteTime": "", "enable512e": true, "iqn": "iqn.2010-01.com.solidfire:testvolume1.1", "name": "testVolume1", "purgeTime": "", "qos": { "burstIOPS": 15000, "burstTime": 60, "curve": { "4096": 100, "8192": 160, "16384": 270, "32768": 500, "65536": 1000, "131072": 1950, "262144": 3900, "524288": 7600, "1048576": 15000 }, "maxIOPS": 15000, "minIOPS": 50 }, "scsiEUIDeviceID": "6a79617900000001f47acc0100000000", "scsiNAADeviceID": "6f47acc1000000006a79617900000001", "sliceCount": 1, "status": "active", "totalSize": 5000658944, "virtualVolumeID": null, "volumeAccessGroups": [], "volumeID": 1, "volumePairs": [] } ] } }
自版本以来的新增功能
9.6