Get Information about a Device in Service Insight
Use this API to retrieve information about a device in Junos Space Service Insight.
URI
https://[host]/api/juniper/serviceinsight/ExposureAnalyzer/sidevices/{id} (HTTP method = GET)
URI Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
id | Integer | Yes | ID of the device to retrieve information |
Consumes
None
Produces
- application/vnd.juniper.serviceinsight.exposureanalyzer.device+xml;version=2
- application/vnd.juniper.serviceinsight.exposureanalyzer.device+json;version=2
Response
Element | Type | Description |
|---|---|---|
key | Integer | Unique key to identify the device |
hostName | String | Device hostname |
ipAddress | String | Device IP address |
serialNumber | String | Device serial number |
eolStatus | String | Indicates whether EOL data is available or not EOL data is not available unless there has been an EOL bulletin. |
lastUpdated | String | Date and time the device information was last updated |
productName | String | Device product name, such as SRX 650 |
deviceGroup | String | Device group name with which this device is associated |
EOLParts | String | Number of parts in this device that has reached EOL status |
connectedMember | String | If an end-customer device, the end customer with which this device is associated |
matchingPBNs | String | Number of Proactive Bug Notifications (PBNs) associated with this device |
connectionStatus | String | Indicates whether this device is powered on or off |
criticalPBNs | Integer | Number of PBNs with a severity of Critical |
majorPBNs | Integer | Number of PBNs with a severity of Major |
Sample Output
Sample XML Output
<device uri="/api/juniper/serviceinsight/exposureanalyzer/sidevices/196609"> <hostName>elmo</hostName> <id>196609</id> <ipAddress>192.0.2.47</ipAddress> <serialNumber>J1213</serialNumber> <eolStatus>EOL Data available</eolStatus> <lastUpdated>2012-03-07 23:00:51.0</lastUpdated> <productName>M7I</productName> <organization href="/api/juniper/servicenow/organization-management/organization/99508"> <id>99508</id> <name>testOrg</name> </organization> <deviceGroup href="/api/juniper/servicenow/device-group-management/deviceGroup/99509"> <id>99509</id> <name>testDeviceGroup</name> </deviceGroup> <EOLParts>3</EOLParts> <connectedMember></connectedMember> <matchingPBNs>4</matchingPBNs> <connectionStatus>up</connectionStatus> <criticalPBNs>0</criticalPBNs> <majorPBNs>0</majorPBNs> </device>
Sample JSON Output
device:{
uri:'/api/juniper/serviceinsight/exposureanalyzer/sidevices/196609',
hostname:'elmo',
id:196609,
ipaddress:'192.0.2.47',
serialnumber:'J1213',
eolstatus:'EOL Data available',
lastupdated:'2012-03-07 23:00:51.0',
productname:'M7I',
organization:{
href:'/api/juniper/servicenow/organization-management/organization/99508',
id:99508,
name:'testOrg'
},
devicegroup:{
href:'/api/juniper/servicenow/device-group-management/deviceGroup/99509',
id:99509,
name:'testDeviceGroup'
},
eolparts:3,
connectedmember:{
},
matchingpbns:4,
connectionstatus:'up',
criticalpbns:0,
majorpbns:0
}
Response Status Code
Message | Description |
|---|---|
204 No Content | Invalid device ID |
