---
title: "Get inventory of a host"
method: GET
path: "/api/host/{hostname}/inventory"
tags: ["Host"]
---

# Get inventory of a host

`GET /api/host/{hostname}/inventory`

## Path parameters

- `hostname` string, required

## Query parameters

- `refresh` string

## Response `200`

OK

- object
  - `addr` string, required — Host address
  - `devices` object[], required — Host devices
    - `available` boolean, required — If the device can be provisioned to an OSD
    - `device_id` string, required — Device's udev ID
    - `human_readable_type` string, required — Device type. ssd or hdd
    - `lsm_data` object, required
      - `errors` string[], required
      - `health` string, required
      - `ledSupport` object, required
        - `FAILstatus` string, required
        - `FAILsupport` string, required
        - `IDENTstatus` string, required
        - `IDENTsupport` string, required
      - `linkSpeed` string, required
      - `mediaType` string, required
      - `rpm` string, required
      - `serialNum` string, required
      - `transport` string, required
    - `lvs` object[], required
      - `block_uuid` string, required
      - `cluster_fsid` string, required
      - `cluster_name` string, required
      - `name` string, required
      - `osd_fsid` string, required
      - `osd_id` string, required
      - `osdspec_affinity` string, required
      - `type` string, required
    - `osd_ids` integer[], required — Device OSD IDs
    - `path` string, required — Device path
    - `rejected_reasons` string[], required
    - `sys_api` object, required
      - `human_readable_size` string, required
      - `locked` integer, required
      - `model` string, required
      - `nr_requests` string, required
      - `partitions` object, required
        - `partition_name` object, required
          - `holders` string[], required
          - `human_readable_size` string, required
          - `sectors` string, required
          - `sectorsize` integer, required
          - `size` integer, required
          - `start` string, required
      - `path` string, required
      - `removable` string, required
      - `rev` string, required
      - `ro` string, required
      - `rotational` string, required
      - `sas_address` string, required
      - `sas_device_handle` string, required
      - `scheduler_mode` string, required
      - `sectors` integer, required
      - `sectorsize` string, required
      - `size` integer, required
      - `support_discard` string, required
      - `vendor` string, required
  - `labels` string[], required — Host labels
  - `name` string, required — Hostname

## Other responses

- `400` — Operation exception. Please check the response body for details.
- `401` — Unauthenticated access. Please login first.
- `403` — Unauthorized access. Please check your permissions.
- `500` — Unexpected error. Please check the response body for the stack trace.

---

[API](https://skmtc.net/ceph/apis/ceph-rest-api.md) · [All operations](https://skmtc.net/ceph/apis/ceph-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ceph/ceph-rest-api/versions/b03ae23c3806/schema)