| Method | URI | Description |
|---|---|---|
| GET | /v2/{tenant_id}/os-hosts{?service,zone} | Lists hosts. |
Normal response codes: 200
This table shows the URI parameters for the list hosts request:
| Name | Type | Description |
|---|---|---|
| String | The ID for the tenant or account in a multi-tenancy cloud. |
This table shows the query parameters for the list hosts request:
| Name | Type | Description |
|---|---|---|
| String (Optional) | The service name. To filter the returned
list by service name, specify
|
| String (Optional) | The zone. To filter the returned list by
zone, specify |
Example 3.215. List hosts: JSON response
{
"hosts": [
{
"host_name": "787f4f6dda1b409bb8b2f9082349690e",
"service": "compute",
"zone": "nova"
},
{
"host_name": "a98b433151084aee8b1a986e28823b36",
"service": "cert",
"zone": "internal"
},
{
"host_name": "c56158d13a884a87abf9171efb7de9d8",
"service": "network",
"zone": "internal"
},
{
"host_name": "81d5cdcda0014918b3ebd3503a2e5c9a",
"service": "scheduler",
"zone": "internal"
},
{
"host_name": "6e48bfe1a3304b7b86154326328750ae",
"service": "conductor",
"zone": "internal"
},
{
"host_name": "39f55087a1024d1380755951c945ca69",
"service": "cells",
"zone": "internal"
},
{
"host_name": "7a9a6cb4701f4dee9048fe0bc25d0ee5",
"service": "consoleauth",
"zone": "internal"
}
]
}
Example 3.216. List hosts: XML response
<?xml version='1.0' encoding='UTF-8'?> <hosts> <host zone="internal" host_name="02ff30050a0d4ce486e60e946a97d28f" service="conductor"/> <host zone="nova" host_name="69dd365b9eae459883a50d1fe7b3c40b" service="compute"/> <host zone="internal" host_name="059ca4da76cf49e8a3d08d2303542157" service="cert"/> <host zone="internal" host_name="ea70b9f0c530497fba8571deb4835ab0" service="network"/> <host zone="internal" host_name="7d52ad3988504fb18b0cdfd94dbd267b" service="scheduler"/> <host zone="internal" host_name="dc36bce962cc49c2ab916287bcf6c9d3" service="cells"/> <host zone="internal" host_name="4bd7bbcc80064d21a5fd0bd53318c6fa" service="consoleauth"/> </hosts>
This operation does not return a response body.
