This URL gets the list of new hosts.
Resource URL
GET /ntbamonitors/{ntbaId}/newhosts? TopN=<TopN>
Request Parameters
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| ntbaId | NTBA monitor id | Number | Yes |
| TopN | Number of top rows, default 50. | Number | No |
Response Parameters
Following fields are returned if the request parameters are correct, otherwise error details are returned.
| Field Name | Description | Data Type |
|---|---|---|
| newHostsOnNetwork | List of hosts | Array |
Details of newHostsOnNetwork:
| Field Name | Description | Data Type |
|---|---|---|
| endpointIp | Host IP | String |
| hostId | Host id | Number |
| lastseen | Last seen | String |
| zone | Zone details | String |
Example
Request
GET https://%3CNSM_IP%3E/sdkapi/ntbamonitors/1006/newhosts
Response
{
"newHostsOnNetwork":[{"
endpointIp":"10.10.10.60","hostId":62,"zone":"Default Inside Zone","lastSeen":"2013-08-27 16:32:48"}]
} Error Information
Following error codes are returned by this URL:
| S.No | HTTP Error Code | SDK API errorId | SDK API errorMessage |
|---|---|---|---|
| 1 | 400 | 4301 | Invalid duration |
| 2 | 400 | 4302 | Invalid time format |
| 3 | 400 | 4303 | Start time is greater than end time |
| 4 | 400 | 4304 | Invalid date format |
| 5 | 400 | 4305 | Start/End date is not provided |
| 6 | 400 | 4306 | Invalid NTBA id |