GET
/v5/agents
Agent List
Returns a list of all agents available to your account in ThousandEyes, including both Enterprise and Cloud agents.
Optional Parameters
agentTypes=CLOUD|ENTERPRISE|ENTERPRISE_CLUSTERoptional, specifies the type of agents requested. Accepts either a single allowed value or a comma-separated list of allowed valuesformat=json|xmloptional, specifies the format of output requested. See Output Formats for more informationaid={accountId}optional and requires the user to be assigned to the target account, specifies the account context of the request, obtained from the/accountsendpoint. Specifying this parameter without the user to be assigned to the target account will result in an error response. See Account Context for more information
Request
- no request body
Example
$curl https://api.thousandeyes.com/v5/agents.json \
-u noreply@thousandeyes.com:g351mw5xqhvkmh1vq6zfm51c62wyzib2
Response
Sends back an array of agents, specifying agentId, which can be used by other areas of the API. The agent’s public IP addresses will be shown, along with last. If an agent is an Enterprise agent, the agent’s public and private IP addresses will be shown, as well as the public network in which the agent is located.
| Field | Data Type | Units | Notes |
|---|---|---|---|
| agentId | integer | n/a | unique ID of agent |
| agentName | string | n/a | display name of the agent |
| agentType | string | n/a | Cloud, Enterprise or Enterprise Cluster, shows the type of agent |
| countryId | string | n/a | ISO-3166-1 alpha-2 country code of the agent |
| clusterMembers | array | n/a | if an enterprise agent is clustered, detailed information about each cluster member will be shown as array entries in the clusterMembers field. This field is not shown for Enterprise Agents in standalone mode, or for Cloud Agents. |
| ipAddresses | array | n/a | array of ipAddress entries |
| groups | array | n/a | array of label objects - see Labels for more information. |
| location | string | n/a | location of the agent |
| prefix | string | n/a | Network prefix, expressed in CIDR format (Enterprise Agents only) |
| enabled | boolean | n/a | 1 for enabled, 0 for disabled (Enterprise Agents only) |
| network | string | n/a | name of the autonomous system in which the Agent is found (Enterprise Agents only) |
| lastSeen | dateTime | n/a | yyyy-MM-dd hh:mm:ss, expressed in UTC (Enterprise Agents only) |
| agentState | string | n/a | Online, Offline or Disabled (standalone Enterprise Agents only) |
| verifySslCertificates | boolean | n/a | 1 for enabled, 0 for disabled (Enterprise Agents only) |
| keepBrowserCache | boolean | n/a | 1 for enabled, 0 for disabled (Enterprise Agents only) |
| utilization | integer | percentage | shows overall utilization percentage (online Enterprise Agents only) |
if the AgentType is Enterprise Cluster, a clusterMembers field will be available, which is an array of clusterMember objects, containing the following fields:
| Field | Data Type | Units | Notes |
|---|---|---|---|
| name | string | n/a | name of the cluster member |
| ipAddresses | array | n/a | array of ipAddress entries |
| publicIpAddresses | array | n/a | array of ipAddress entries |
| prefix | string | n/a | Network prefix, expressed in CIDR format (Enterprise Agents only) |
| network | string | n/a | name of the autonomous system in which the Agent is found (Enterprise Agents only) |
| lastSeen | dateTime | n/a | yyyy-MM-dd hh:mm:ss, expressed in UTC (Enterprise Agents only) |
| agentState | string | n/a | either Online or Offline |
| utilization | integer | percentage | shows overall utilization percentage |
Header
HTTP/1.1 200 OK
Date: Thu, 07 Nov 2013 07:32:48 GMT
Server: Apache/2.2.22 (Ubuntu)
Transfer-Encoding: chunked
Content-Type: application/json
Body
{
"agents": [
{
"agentId": 6,
"agentName": "Fremont, CA (v6)",
"agentType": "Cloud",
"countryId": "US",
"ipAddresses": [
"2600:3c01::f03c:91ff:feae:4f96"
],
"location": "San Francisco Area"
},
{
"agentId": 11,
"agentName": "London, UK",
"agentType": "Cloud",
"countryId": "GB",
"ipAddresses": [
"176.58.99.46",
"178.79.138.106"
],
"location": "City of London, United Kingdom"
},
{
"agentId": 29,
"agentName": "Sample Enterprise Agent",
"location": "United States",
"countryId": "US",
"prefix": "38.0.0.0/8",
"ipAddresses": [
"10.100.50.25"
],
"publicIpAddresses": [
"38.122.6.66"
],
"network": "Cogent Communications (AS 174)",
"agentType": "Enterprise",
"lastSeen": "2015-02-05 23:23:33",
"agentState": "Online"
},
{
"agentId": 1975,
"agentName": "Duke cluster",
"location": "San Francisco Bay Area",
"countryId": "US",
"enabled": 1,
"verifySslCertificates": 1,
"keepBrowserCache": 0,
"clusterMembers": [
{
"name": "duke_agent3.thousandeyes.net",
"ipAddresses": [
"172.17.0.2"
],
"publicIpAddresses": [
"38.122.6.66"
],
"prefix": "38.0.0.0/8",
"utilization": 1,
"network": "Cogent Communications (AS 174)",
"lastSeen": "2015-07-15 17:16:11",
"agentState": "Online"
},
[...]
],
"agentType": "Enterprise Cluster"
}
]
}
For error responses, see the response status codes documentation.