v1

latestOpenAPI 3.0.0Apache 2.02026-07-174040133.9 KB
Masking views

List all storage hosts.

get/v1/storages/{storage_id}/storage-hosts

Path parameters

storage_idstring required

Database ID created for a storage backend.

Query parameters

limitinteger

Requests a page size of items. Returns a number of items up to a limit value. Use the limit parameter to make an initial limited request and use the ID of the last-seen item from the response as the marker parameter value in a subsequent limited request.

offsetinteger

Used in conjunction with limit to return a slice of items. offset is where to start in the list.

sortstring
Example:sort=name:desc,id:asc

Comma-separated list of sort keys and optional sort directions in the form of key:val

namestring

The storage host name

idstring

Database ID created for a storage host.

descriptionstring

The storage host description

native_storage_host_idstring

Actual ID of the storage host in the storage backend.

status'normal' | 'offline' | 'abnormal' | 'unknown'

The storage host status

ip_addressstring

Ip address of the storage host.

os_type'windows' | 'linux'

Operating system of the storage host

Response

List storage hosts query was success

Example response

{
  "storage_hosts": [
    {
      "id": "084bf71e-a102-11e7-88a8-e31fe6d52248",
      "created_at": "2017-07-10T14:36:58.014Z",
      "updated_at": "2017-07-10T14:36:58.014Z",
      "storage_id": "084bf71e-a102-11e7-88a8-e31fe6d52248",
      "native_storage_host_id": "storage_host_0",
      "ip_address": "192.168.1.4"
    }
  ]
}