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"
		}
	]
}