Image status
Documentation for Image status
Read time 1 minuteLast updated 2 hours ago
Get the rollout status of the image specified by
<imageid>
https://api.multiplay.co.uk/cfp/v2/project/<accountserviceid>/image/<imageid>/status
METHOD |
GET |
Request parameters
VARIABLE | DESCRIPTION | OPTIONAL |
accountserviceid | The
| No |
imageid | The
| No |
detail | The
If set to
If excluded or set to
| Yes |
Response fields
Field | Type | Description | Optional |
---|---|---|---|
fleets | object | List of fleet objects, included only if detail parameter set to true | Yes |
pending_machines | integer | Number of running machines currently pending installs | No |
failed_machines | integer | Number of disabled machines currently unable to install | No |
completed_machines | integer | Number of running machines fully installed | No |
Fleet status object
Field | Type | Description | Optional |
---|---|---|---|
regions | object | Map of region IDs to region status objects | No |
pending_machines | integer | Number of running machines currently pending installs | No |
failed_machines | integer | Number of disabled machines currently unable to install | No |
completed_machines | integer | Number of running machines fully installed | No |
Region status object
Field | Type | Description | Optional |
---|---|---|---|
name | string | Name of the region | No |
pending_machines | integer | Number of running machines currently pending installs | No |
failed_machines | integer | Number of disabled machines currently unable to install | No |
completed_machines | integer | Number of running machines fully installed | No |
Example request
curl --location --request GET 'https://api.multiplay.co.uk/cfp/v2/project/<accountserviceid>>/image/<imageid>>/status?detail=<detail>' \ --header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'
Example response
{ "fleets": { <fleetid>: { "regions": { <regionid>: { "name": <region_name>, "pending_machines": <pending_machines>, "completed_machines": <completed_machines> }, }, "pending_machines": <pending_machines>, "completed_machines": <completed_machines> }, ... }, "pending_machines": <pending_machines>, "completed_machines": <completed_machines> }