ListVolumes
Sugerir cambios
PDF
Puede usar el ListVolumes método para obtener una lista de volúmenes que hay en un clúster. Para especificar los volúmenes que desea volver en la lista, se pueden especificar los parámetros disponibles.
Parámetros
Este método tiene los siguientes parámetros de entrada:
| Nombre | Descripción | Tipo | Valor predeterminado | Obligatorio |
|---|---|---|---|---|
cuentas |
Solo se devuelven los volúmenes propiedad de las cuentas especificadas aquí. Se excluyen mutuamente con el parámetro volumeID. |
matriz en números enteros |
Ninguno |
No |
IncludeVirtualVolumes |
De forma predeterminada, se incluyen los volúmenes virtuales en la respuesta. Para excluir volúmenes virtuales, se debe establecer en FALSE. |
booleano |
verdadero |
No |
IsPaireado |
Devuelve volúmenes emparejados o que no están emparejados. Los posibles valores son los siguientes:
|
booleano |
Ninguno |
No |
límite |
Permite configurar el número máximo de resultados de volumen que se devuelven. Se excluyen mutuamente con el parámetro volumeID. |
entero |
10000 |
No |
StartVolumeID |
Solo se muestran los volúmenes con un ID mayor o igual que este valor. Se excluyen mutuamente con el parámetro volumeID. |
entero |
Ninguno |
No |
ID de volumen |
Una lista de ID de volumen. Si se especifica este parámetro, otros parámetros únicamente funcionan en este conjunto de volúmenes. Se excluyen mutuamente con los parámetros Accounts, startVolumeID y limit. |
matriz en números enteros |
No |
No |
Nombre de volumen |
Solo se devuelve la información de objetos de volumen que coincide con el nombre del volumen. |
cadena |
No |
No |
Estado de volumen |
Solo se devuelven los volúmenes con el estado igual que el valor status. Los posibles valores son los siguientes:
|
cadena |
No |
No |
Valor de retorno
Este método tiene el siguiente valor devuelto:
Nombre |
Descripción |
Tipo |
volúmenes |
Lista de volúmenes. |
volumen cabina |
Ejemplo de solicitud
Las solicitudes de este método son similares al ejemplo siguiente:
{
"method": "ListVolumes",
"params": {
"volumeIDs": [1],
"volumeStatus": "active",
"isPaired": "false"
},
"id": 1
}
Ejemplo de respuesta
Este método devuelve una respuesta similar al siguiente ejemplo:
{
"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": []
}
]
}
}
Nuevo desde la versión
9,6