SOsodafoundation
Storages

GET /v1/storages

Changed on

List all registered storage back ends

Request

  • The document declares no server URL.
  • Auth
    none declared

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

vendorstring

vendor(manufacturer) of the storage.

modelstring

model of the storage

namestring

The storage name.

serial_numberstring

The storage serial number.

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

The storage status

Response

Storage backend list available.

Example response

{
  "storages": [
    {
      "name": "EMC-VMAX-123456",
      "description": "VMAX storage lab1",
      "vendor": "Dell EMC",
      "model": "VMAX250F",
      "status": "normal",
      "serial_number": "0002004355"
    }
  ]
}

Changes

  • 3d3829cf1352Revision changes
    • breaking

      removed the enum value Abnormal from the query request parameter status

    • breaking

      removed the enum value Normal from the query request parameter status

    • breaking

      removed the enum value Offline from the query request parameter status

    • info

      added the new enum value abnormal to the query request parameter status

    • info

      added the new enum value normal to the query request parameter status

    • info

      added the new enum value offline to the query request parameter status

  • 82d18ce56636Revision changes
    • info

      added the optional property // to the response with the status