| Verb | URI | Description |
| GET | /agents | List agents which report their status to OpenStack Networking server. |
Normal Response Code: 200
This operation does not require a request body.
This operation returns a response body. The default policy behavior is that non-admin user won't be able to see any agent in the response when this call is invoked
Example 4.62. List Agents: JSON Request
GET /v2.0/agents HTTP/1.1
Host: controlnode:9696
User-Agent: python-neutronclient
Content-Type: application/json
Accept: application/json
X-Auth-Token: c52a1b304fec4ca0ac85dc1741eec6e2
Example 4.63. List Agents: JSON Response
{
"agents":[
{
"binary":"neutron-dhcp-agent",
"description":null,
"admin_state_up":false,
"heartbeat_timestamp":"2013-03-26T09:35:13.000000",
"alive":false,
"id":"af4567ad-c2e6-4311-944d-22efc12f89af",
"topic":"dhcp_agent",
"host":"HostC",
"agent_type":"DHCP agent",
"started_at":"2013-03-26T09:35:01.000000",
"created_at":"2013-03-26T09:35:01.000000",
"configurations":{
"subnets":2,
"use_namespaces":true,
"dhcp_driver":"neutron.agent.linux.dhcp.Dnsmasq",
"networks":2,
"dhcp_lease_time":120,
"ports":3
}
}
]
}
