Apache CloudStack 4.20.0.0 Root Admin API Reference

listNics

list the vm nics IP to NIC

Request parameters

Parameter NameDescriptionRequired
virtualmachineidthe ID of the vmtrue
fordisplaylist resources by display flag; only ROOT admin is eligible to pass this parameterfalse
keywordList by keywordfalse
networkidlist nic of the specific vm's networkfalse
nicidthe ID of the nic to list IPsfalse
pagefalse
pagesizefalse

Response Tags

Response NameDescription
idthe ID of the nic
adaptertypeType of adapter if available
broadcasturithe broadcast uri of the nic
deviceiddevice id for the network when plugged into the virtual machine
extradhcpoptionthe extra dhcp options on the nic
gatewaythe gateway of the nic
ip6addressthe IPv6 address of network
ip6cidrthe cidr of IPv6 network
ip6gatewaythe gateway of IPv6 network
ipaddressthe ip address of the nic
ipaddressesIP addresses associated with NIC found for unmanaged VM
isdefaulttrue if nic is default, false otherwise
isolatedpvlanthe isolated private VLAN if available
isolatedpvlantypethe isolated private VLAN type if available
isolationurithe isolation uri of the nic
macaddresstrue if nic is default, false otherwise
mtuMTU configured on the NIC
netmaskthe netmask of the nic
networkidthe ID of the corresponding network
networknamethe name of the corresponding network
nsxlogicalswitchId of the NSX Logical Switch (if NSX based), null otherwise
nsxlogicalswitchportId of the NSX Logical Switch Port (if NSX based), null otherwise
publicippublic IP address associated with this nic via Static nat rule
publicipidpublic IP address id associated with this nic via Static nat rule
secondaryipthe Secondary ipv4 addr of nic
traffictypethe traffic type of the nic
typethe type of the nic
virtualmachineidId of the vm to which the nic belongs
vlanidID of the VLAN/VNI if available
vpcidId of the vpc to which the nic belongs
vpcnamename of the vpc to which the nic belongs