SOsodafoundation
Host

GET /v1beta/{tenantId}/host/hosts

Changed on

Lists host information.

Request

  • Base URL
    https://localhost:50040
  • Auth
    HTTP basic

Query parameters

limitinteger

Number of query results on multiple pages

offsetinteger

Start position of the pagination query

sortDir'asc' | 'desc'

Ascending or descending

sortKeystring

Sorting key word, such as hostName, createdAt

hostNamestring

Host name

Response

OK

idstring
createdAtstring date-time
updatedAtstring date-time
tenantIdstring
hostNamestring
osTypestring
accessModestring
ipstring
portstring
usernamestring
availabilityZonesstring[]

Example response

[
  {
    "id": "084bf71e-a102-11e7-88a8-e31fe6d52248",
    "createdAt": "2017-07-10T14:36:58.014Z",
    "updatedAt": "2017-07-10T14:36:58.014Z",
    "initiators": [
      {
        "portName": "20000024ff5bb888",
        "protocol": "iscsi"
      }
    ]
  }
]

Changes

  • b151718b45cfRevision changes
    • breaking

      removed the enum value createdAt from the query request parameter sortKey

    • breaking

      removed the enum value hostName from the query request parameter sortKey

  • 0d720ad6985aRevision changes
    • info

      added the new enum value createdAt to the query request parameter sortKey