List servers 1
Method | URI | Description |
---|---|---|
GET | /v2/{tenant_id}/servers{?changessince,image,flavor,name,status,host} | Lists IDs, names, and links for all servers. |
Normal response codes: 200, 203
Request
This table shows the URI parameters for the list servers request:
Name | Type | Description |
---|---|---|
{tenant_id} | UUID | Project ID |
This table shows the query parameters for the list servers request:
Name | Type | Description |
---|---|---|
changes-since | DateTime (Optional) |
A time/date stamp for when the server last changed status. |
image | AnyURI (Optional) |
Name of the image in URL format. |
flavor | AnyURI (Optional) |
Name of the flavor in URL format. |
name | String (Optional) |
Name of the server as a string. |
status | Server Status (Optional) |
Value of the status of the server so that you can filter on "ACTIVE" for example. |
host | String (Optional) |
Name of the host as a string. |
Response
Example. List servers: JSON response
{
"servers": [
{
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
"links": [
{
"href": "http://openstack.example.com/v2/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19",
"rel": "self"
},
{
"href": "http://openstack.example.com/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19",
"rel": "bookmark"
}
],
"name": "new-server-test"
}
]
}