Resume environment osquery rollout

POST

/api/v1/environments/osquery/{env}/rollout/resume

curl --request POST \
  --url https://example.com/api/v1/environments/osquery/example/rollout/resume \
  --header 'Authorization: <Authorization>'

Resumes a paused rollout at the stage it paused in and restarts that stage’s wait. Answers 409 unless the rollout is paused. The host names and reasons in the response are reported by hosts and are untrusted. Environment admins.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

env

required

string

Environment name or UUID

Responses

200

OK

Media typeapplication/json

object

available

Available lists the library version names (no digests), ascending.

Array<string>

counts

Array<object>

object

count

integer

version

string

rollout

Rollout is the environment’s latest rollout, null when it never had one.

object

counts

object

eligible

integer

rolled_back

integer

upgraded

integer

waiting

integer

next_stage_at

string

paused

object

at

string

host

string

reason

string

request_id

string

rolled_back_hosts

RolledBackHosts is newest first, at most 50.

Array<object>

object

at

string

host

string

reason

string

stage

integer

stage_opened_at

string

stages

Array<integer>

state

string

version

string

target

object

request_id

string

updated_at

string

updated_by

string

version

string

windows_hosts

WindowsHosts is the number of Windows hosts in the environment; Windows upgrades cannot be rolled back automatically.

integer

Example^generated

{
  "available": [
    "example"
  ],
  "counts": [
    {
      "count": 1,
      "version": "example"
    }
  ],
  "rollout": {
    "counts": {
      "eligible": 1,
      "rolled_back": 1,
      "upgraded": 1,
      "waiting": 1
    },
    "next_stage_at": "example",
    "paused": {
      "at": "example",
      "host": "example",
      "reason": "example"
    },
    "request_id": "example",
    "rolled_back_hosts": [
      {
        "at": "example",
        "host": "example",
        "reason": "example"
      }
    ],
    "stage": 1,
    "stage_opened_at": "example",
    "stages": [
      1
    ],
    "state": "example",
    "version": "example"
  },
  "target": {
    "request_id": "example",
    "updated_at": "example",
    "updated_by": "example",
    "version": "example"
  },
  "windows_hosts": 1
}

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

Not found

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

409

Rollout is not paused

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

500

Internal server error

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}