INC Platform - Resource Manager

Query Interface Details

Query interface details based on interface index and device ID.

Interface URI

/plat/res/device/{deviceId}/interface/{ifIndex}

Access Method

HTTP
GET
Parameters
Path parameter
deviceId Device ID.
Long integer type. Required. No default value.
ifIndex Interface index.
Long integer type. Required. No default value.

Returned Result

Status codes
  • 200 (OK): Success.
Message header
HTTP/1.1 200 OK
Content-Type: application/xml
Message body
<interface>
<ifIndex>1</ifIndex>
<ifType>24</ifType>
<ifTypeDesc>SOFTWARELOOPBACK</ifTypeDesc>
<ifDescription>lo</ifDescription>
<adminStatus>1</adminStatus>
<adminStatusDesc>Up</adminStatusDesc>
<operationStatus>1</operationStatus>
<operationStatusDesc>Up</operationStatusDesc>
<ifspeed>10000000</ifspeed>
<appointedSpeed>-1</appointedSpeed>
<ifAlias/>
<phyAddress/>
<mtu>1500</mtu>
<lastChange>0 days 0 hours 0 minutes 0 seconds 0 milliseconds</lastChange>
<ifFeType>1</ifFeType>
<ipHash>
<item>127.0.0.1</item>
<item>255.0.0.0</item>
</ipHash>
</interface>
Element description
interface sub-elements
ifIndex Interface index.
Long integer type.
ifType Interface type. 0:VIRTUAL. 1:OTHER. 2:REGULAR1822. 3:HDH1822. 4:DDNX25. 5: RFC877X25. 6: ETHERNETCSMACD. 7: ISO88023CSMACD. 8: ISO88024TOKENBUS. 9: ISO88025TOKENRING. 10: ISO88026MAN. 11: STARLAN. 12: PROTEON10MBIT. 13: PROTEON80MBIT. 14: HYPERCHANNEL. 15: FDDI. 16: LAPB. 17: SDLC. 18: DS1. 19: E1. 20: BASICISDN. 21: PRIMARYISDN. 22: PROPPOINTTOPOINTSERIAL. 23: PPP. 24: SOFTWARELOOPBACK. 25: EON. 26: ETHERNET3MBIT. 27: NSIP. 28: SLIP. 29: ULTRA. 30: DS3. 31: SIP. 32: FRAMERELAY. 33: RS232. 34: PARA. 35: ARCNET. 36: ARCNETPLUS. 37: ATM. 38: MIOX25. 39:SONET. 40:X25PLE. 41:ISO88022LLC. 42:LOCALTALK. 43:SMDSDXI. 44:FRAMERELAYSERVICE. 45:V35. 46:HSSI. 47:HIPPI. 48:MODEM. 49:AAL5. 50:SONETPATH. 51:SONETVT. 52:SMDSICIP. 53:PROPVIRTUAL. 54:PROPMULTIPLEXOR. 55:IEEE80212. 56:FIBRECHANNEL. 57:HIPPIINTERFACE. 58:FRAMERELAYINTERCONNECT. 59:AFLANE8023. 60:AFLANE8025. 61:CCTEMUL. 62:FASTETHER. 63:ISDN. 64:V11. 65:V36. 66:G703AT64K. 67:G703AT2MB. 68:QLLC. 69:FASTETHERFX. 70:CHANNEL. 71:IEEE80211. 72:IBM370PARCHAN. 73:ESCON. 74:DLSW. 75:ISDNS. 76:ISDNU. 77:LAPD. 78:IPSWITCH. 79:RSRB. 80:ATMLOGICAL. 81:DS0. 82:DS0BUNDLE. 83:BSC. 84:ASYNC. 85:CNR. 86:ISO88025DTR. 87:EPLRS. 88:ARAP. 89:PROPCNLS. 90:HOSTPAD. 91:TERMPAD. 92:FRAMERELAYMPI. 93:X213. 94:ADSL. 95:RADSL. 96:SDSL. 97:VDSL. 98:ISO88025CRFPINT. 99:MYRINET. 100:VOICEEM. 101:VOICEFXO. 102:VOICEFXS. 103:VOICEENCAP. 104:VOICEOVERIP. 105:ATMDXI. 106:ATMFUNI. 107:ATMIMA. 108:PPPMULTILINKBUNDLE. 109:IPOVERCDLC. 110:IPOVERCLAW. 111:STACKTOSTACK. 112:VIRTUALIPADDRESS. 113:MPC. 114:IPOVERATM. 115:ISO88025FIBER. 116:TDLC. 117:GIGABITETHERNET. 118:HDLC. 119:LAPF. 120:V37. 121:X25MLP. 122:X25HUNTGROUP. 123:TRASNPHDLC. 124:INTERLEAVE. 125:FAST. 126:IP. 127:DOCSCABLEMACLAYER. 128:DOCSCABLEDOWNSTREAM. 129:DOCSCABLEUPSTREAM. 130:A12MPPSWITCH. 131:TUNNEL. 132:COFFEE. 133:CES. 134:ATMSUBINTERFACE. 135:L2VLAN. 136:L3IPVLAN. 137:L3IPXVLAN. 138:DIGITALPOWERLINE. 139:MEDIAMAILOVERIP. 140:DTM. 141:DCN. 142:IPFORWARD. 143:MSDSL. 144:IEEE1394. 145:IF_GSN. 146:DVBRCCMACLAYER. 147:DVBRCCDOWNSTREAM. 148:DVBRCCUPSTREAM. 149:ATMVIRTUAL. 150:MPLSTUNNEL. 151:SRP. 152:VOICEOVERATM. 153:VOICEOVERFRAMERELAY. 154:IDSL. 155:COMPOSITELINK. 156:SS7SIGLINK. 157:propWirelessP2P. 158:frForward. 159:rfc1483. 160:usb. 161:ieee8023adLag. 65534:SWITCHSTACK.
Integer type.
ifTypeDesc Interface type description.
String type.
ifDescription Interface description.
String type.
adminStatus Management status. 1: Up. 2: Down.
Integer type.
adminStatusDesc Management status description.
String type.
operationStatus Operation status. 1: Up. 2: Down. 3: Testing. 4: Unknown. 5: Dormant. 6: Not present. 7: LowerLayerDown.
Integer type.
operationStatusDesc Operation status description.
String type.
ifspeed Interface speed(B).
Long integer type.
appointedSpeed Specify speed.
Long integer type.
ifAlias Interface alias.
String type.
phyAddress MAC address.
String type.
mtu MTU.
Integer type.
lastChange Last change.
String type.
ipHash The first item is IP. The second item is mask.
String type.
ifFeType Media Type. 0: Other. 1: Fibreoptical. 2: Electrical.
Long integer type.
lastChangeTime Last change.
String type.

Example

Query information about the interface with the index 1 and device ID 2.

Request
GET http://host:8080/imcrs/plat/res/device/2/interface/1
accept: application/xml
...
        
Response
HTTP/1.1 200 OK
Content-Type: application/xml
...
 <interface>
<ifIndex>1</ifIndex>
<ifType>24</ifType>
<ifTypeDesc>SOFTWARELOOPBACK</ifTypeDesc>
<ifDescription>lo</ifDescription>
<adminStatus>1</adminStatus>
<adminStatusDesc>Up</adminStatusDesc>
<operationStatus>1</operationStatus>
<operationStatusDesc>Up</operationStatusDesc>
<ifspeed>10000000</ifspeed>
<appointedSpeed>-1</appointedSpeed>
<ifAlias/>
<phyAddress/>
<mtu>1500</mtu>
<lastChange>0 days 0 hours 0 minutes 0 seconds 0 milliseconds</lastChange>
<ifFeType>1</ifFeType>
<ipHash>
<item>127.0.0.1</item>
<item>255.0.0.0</item>
</ipHash>
</interface>