list
Overview
List cluster PCI devices
Command Parameters
-h|--host-ids=string Filter by host IDs; JSON array format required
-i|--ids=string Filter by device IDs; JSON array format required
-n|--name=string Filter by device name, example: eth5
-s|--status=string Filter by device status. Values: Offline (offline), Normal (normal). enum=['Offline', 'Normal']
-t|--type=string Filter by device type. Values: iface (network card), encryption (encryption card). enum=['iface', 'encryption']
-m|--model=string Filter by device model, example: VMware VMXNET3 Ethernet Controller
-M|--mode=string Filter by device mode. Values: vf (virtual function), passthrough (passthrough), pf (physical function), none (not configured). enum=['vf', 'passthrough', 'pf', 'none']
--submodule=string Submodule type to include in the list. Values: pf, vf, pci. enum=['pf', 'vf', 'pci']
-e|--excludable-submodule=string Submodule type that cannot be included in the list. Values: pf, vf, pci. enum=['pf', 'vf', 'pci']
-E|--enable=boolean Whether to return only enabled devices
-u|--use-cache=boolean Whether to use cache (default uses cache when omitted; 0/false triggers real-time query)
--start=integer Pagination start position (from 0, min 0); used with --limit, both must be provided together
-l|--limit=integer Page size (max 50); used with --start, both must be provided together
-k|--keyword=string Fuzzy match keyword for PCI devices, example: eth
-S|--sort=string Sort field (defaults to name). Values: status, type, slot, mode, relatedVMS. enum=['status', 'type', 'slot', 'mode', 'relatedVMS']
-d|--direct=string Sort direction. Values: ASC (ascending), DESC (descending); used with --sort. enum=['ASC', 'DESC']
Usage Example
acli hardware pcie list
acli hardware pcie list --host-ids '["host-0050568ec35e"]' --type iface --status Normal
Output Example
{
"pcies": [
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:1b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth5",
"parentID": "0000:1b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:1b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:13:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth4",
"parentID": "0000:13:00.0",
"passthroughSupport": false,
"pciAddr": "0000:13:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:0c:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth3",
"parentID": "0000:0c:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0c:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:0b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth2",
"parentID": "0000:0b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:04:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth1",
"parentID": "0000:04:00.0",
"passthroughSupport": false,
"pciAddr": "0000:04:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568ec35e",
"hostName": "10.131.137.114",
"id": "0000:03:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth0",
"parentID": "0000:03:00.0",
"passthroughSupport": false,
"pciAddr": "0000:03:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:1b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth5",
"parentID": "0000:1b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:1b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:13:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth4",
"parentID": "0000:13:00.0",
"passthroughSupport": false,
"pciAddr": "0000:13:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:0c:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth3",
"parentID": "0000:0c:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0c:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:0b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth2",
"parentID": "0000:0b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:04:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth1",
"parentID": "0000:04:00.0",
"passthroughSupport": false,
"pciAddr": "0000:04:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e74c8",
"hostName": "10.131.136.197",
"id": "0000:03:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth0",
"parentID": "0000:03:00.0",
"passthroughSupport": false,
"pciAddr": "0000:03:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:1b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth5",
"parentID": "0000:1b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:1b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:13:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth4",
"parentID": "0000:13:00.0",
"passthroughSupport": false,
"pciAddr": "0000:13:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:0c:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth3",
"parentID": "0000:0c:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0c:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:0b:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth2",
"parentID": "0000:0b:00.0",
"passthroughSupport": false,
"pciAddr": "0000:0b:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:04:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth1",
"parentID": "0000:04:00.0",
"passthroughSupport": false,
"pciAddr": "0000:04:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
},
{
"children": [],
"device_slot": null,
"enable": false,
"hostID": "host-0050568e3fe4",
"hostName": "10.131.137.124",
"id": "0000:03:00.0",
"mode": "none",
"model": "VMware VMXNET3 Ethernet Controller (rev 01)",
"name": "eth0",
"parentID": "0000:03:00.0",
"passthroughSupport": false,
"pciAddr": "0000:03:00.0",
"pfNum": 0,
"pfNumMaxLimit": 0,
"pfNumMinLimit": 1,
"pfSupport": false,
"pvID": "",
"relatedDevices": [],
"relatedVMS": [],
"runningVMS": [],
"sn": "",
"sriovSupport": false,
"status": "Normal",
"submodule": "pci",
"type": "iface",
"vfNum": 0,
"vfNumMaxLimit": 0,
"vfNumMinLimit": 1
}
],
"total": 18
}