Hosts

Returns a list with all the defined hosts

Changed on Sep 2, 2026

get/hosts/

Request

Base URL
https://quads.example.com/api/v3
URL
https://quads.example.com/api/v3/hosts/
Auth
none declared

Query parameters

namestring

Filter hosts by name.

modelstring

Filter hosts by model name.

host_typestring

Filter hosts by type.

buildboolean

Filter by build status.

validatedboolean

Filter by validated status.

switch_config_appliedboolean

Filter by switch config applied status.

brokenboolean

Filter by broken status.

retiredboolean

Filter by retired status.

last_buildstring

Filter by last build date.

created_onstring

Filter by created on date.

Response

Host name

idinteger

namestring

modelstring

host_typestring

buildboolean

validatedboolean

switch_config_appliedboolean

brokenboolean

retiredboolean

can_self_scheduleboolean

overcloudboolean

rackstring

ulocstring

bladestring

bootmodestring

last_buildstring

cloud_idinteger

default_cloud_idinteger

Example response

[
  {
    "id": 12,
    "name": "host.example.com",
    "model": "r640",
    "host_type": "vendor",
    "build": true,
    "validated": true,
    "switch_config_applied": true,
    "broken": true,
    "retired": true,
    "overcloud": true,
    "rack": "A1",
    "uloc": "U10",
    "blade": "blade1",
    "bootmode": "uefi",
    "last_build": "2022-02-02",
    "cloud_id": 12,
    "default_cloud_id": 1,
    "interfaces": [
      {
        "id": 12,
        "name": "em1",
        "bios_id": "nic1",
        "mac_address": "aa:00:bb:11:cc:22",
        "switch_ip": "10.1.1.18",
        "switch_port": "xt-0-0/1",
        "speed": 1000,
        "vendor": "Intel",
        "pxe_boot": true,
        "host_id": 10
      }
    ],
    "disks": [
      {
        "disk_id": 1,
        "disk_type": "nvme",
        "size_gb": 2000,
        "count": 10,
        "host_id": 10
      }
    ],
    "memory": [
      {
        "id": 12,
        "size_gb": 2000,
        "handle": "MMD",
        "host_id": 10
      }
    ],
    "processors": [
      {
        "id": 12,
        "handle": "CoreI7",
        "vendor": "Intel",
        "product": "i7",
        "cores": 20,
        "threads": 20,
        "processor_type": "x86",
        "host_id": 10
      }
    ]
  }
]

Changes

Sep 2, 202666987ade4877 Revision changes
- breaking
  the response's body type changed from object to array for status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
Aug 25, 2026f6728f2d9024 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history (6 revisions)