virtualip list
Lists the virtual IP addresses in the cluster.
Syntax
- CLI
-
maprcli virtualip list [ -cluster <cluster> ] [ -columns <columns> ] [ -filter <filter> ] [ -limit <limit> ] [ -nfsmacs <NFS macs> ] [ -output <output> ] [ -range <range> ] [ -sortby <attribute> ] [ -start <start> ]
- REST
Request Type GET Request URL http[s]://<host>:<port>/rest/virtualip/list[?<parameters>]
Parameters
Parameter |
Description |
---|---|
cluster |
The cluster on which to run the command. |
columns |
The columns to display. NOTE
|
filter |
A filter specifying VIPs to list. See Filters for more information. |
limit |
The number of records to return. |
nfsmacs |
Specifies whether (1 ) or not (0 ) to
return the MAC addresses of servers running NFS. If value is
1 , the command returns the MAC addresses of the NFS
servers. |
output |
Whether the output should be terse or
verbose . |
range |
Specifies whether (1 ) or not (0 ) to
return the VIP ranges. The default value is 0 , which
returns all VIPs
individually. If:
NOTE The assignables contains the list of MAC
addresses only if the VIP assignment is restricted to a group of nodes.
You must specify -json with the command to view the
assignables . |
sortby |
Specifies one of the following attributes to sort the list of virtual IP
addresses by: vipip , vipendip ,
vipnetmask , vipgateway ,
vipnumdevices , viphealth ,
vipassigneddevname , vipassigneddevip ,
vipassigneddevmac ,
vippreferredhostname , vippreferredip ,
vippreferredmac . |
start |
The index of the first record to return. |
Output
Field | Description |
---|---|
assignables |
The group of nodes to assign the VIP range to. If empty, the range of
VIPs can be assigned to any NFSv3 server. NOTE You must specify
-json with the command to view the
assignables . |
hn |
The hostname. |
ip |
The IP address. |
mac |
The MAC address. |
nm |
The netmask. |
vip |
The virtual IP. If output contains VIP range, this is the start of the VIP range. |
vipe |
The end of the VIP range. |
Examples
Return the list of VIPs:
# maprcli virtualip list
hn ip vip mac nm
atsqa4-164.nfs4ad.com 10.10.88.164 10.10.88.10 0c:c4:7a:1f:91:a5 255.255.255.0
atsqa4-161 10.10.88.161 10.10.88.11 0c:c4:7a:1f:91:0a 255.255.255.0
atsqa4-161 10.10.88.161 10.10.88.12 0c:c4:7a:1f:91:0a 255.255.255.0
atsqa4-162 10.10.88.162 10.10.88.13 0c:c4:7a:1f:92:12 255.255.255.0
atsqa4-164.nfs4ad.com 10.10.88.164 10.10.88.14 0c:c4:7a:1f:91:a5 255.255.255.0
atsqa4-162 10.10.88.162 10.10.88.15 0c:c4:7a:1f:92:12 255.255.255.0
atsqa4-161 10.10.88.161 10.10.88.17 0c:c4:7a:1f:91:0a 255.255.255.0
atsqa4-164.nfs4ad.com 10.10.88.164 10.10.88.18 0c:c4:7a:1f:91:a5 255.255.255.0
curl -X GET 'https://abc.sj.us:8443/rest/virtualip/list' --user <username>:<password>
Return 2 virtual IPs:
# maprcli virtualip list -limit 2
hn ip vip mac nm
atsqa4-164.nfs4ad.com 10.10.88.164 10.10.88.10 0c:c4:7a:1f:91:a5 255.255.255.0
atsqa4-161 10.10.88.161 10.10.88.11 0c:c4:7a:1f:91:0a 255.255.255.0
curl -X GET 'https://server.sj.us:8443/rest/virtualip/list?limit=2' --user <username>:<password>
Return a list of VIP ranges:
# maprcli virtualip list -range 1
assignables vip vipe nm
... 10.10.88.10 10.10.88.13 255.255.255.0
... 10.10.88.14 10.10.88.15 255.255.255.0
... 10.10.88.17 10.10.88.18 255.255.255.0
curl -X GET 'https://server.sj.us:8443/rest/virtualip/list?range=1' --user <username>:<password>