OS upgrade host state

Retrieve all host states

List of hosts that have reported their package versions to the controller.

SecurityaccessToken
Request
query Parameters
fields
string

Retrieve only requested fields from the resource

See section fields

site
string

Send the request to the specfifed site

keys
string <enumeration>

Retrieve only the keys for the list

Value: "true"
count
string <enumeration>

Retrieve only the number of elements in the list

Value: "true"
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

get/v1/state/os-upgrade/hosts
Response samples
- hostname: h01
  timestamp: 2023-03-17T01:12:24Z
  versions:
    linux-image: 5.15.83-ubuntu0
    docker: 20.10.1
  

Retrieve a host state

List of hosts that have reported their package versions to the controller.

SecurityaccessToken
Request
path Parameters
host-state-hostname
required
string <domain-name>

hostname of host-state

query Parameters
fields
string

Retrieve only requested fields from the resource

See section fields

site
string

Send the request to the specfifed site

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

get/v1/state/os-upgrade/hosts/{host-state-hostname}
Response samples
hostname: h01
timestamp: 2023-03-17T01:12:24Z
versions:
  linux-image: 5.15.83-ubuntu0
  docker: 20.10.1