Screens
Resize screen
Change a screen’s resolution.
PATCH
Resizes a screen in place with
xrandr, so the X server is not restarted and
every window already open on the screen is kept.
Path parameters
Computer ID (UUID). The computer must be up. One that is still being created,
or that has been frozen, returns
400.Body parameters
Both are required here, unlike create, which falls back to the size of the boot screen. A resize is an explicit change, so there is no fallback. A missing, zero, or negative dimension is refused with400 and the message width and height are required.
Response
Returns the screen with its newwidth and
height. Every other field is unchanged: resizing does not move a screen to a
different display, and its vnc_port and ws_port stay where they were.
An extra screen’s new size is recorded before the response, so the screen comes
back at that size after a restart, as described in
Screens after a restart.
The boot screen’s size is not recorded: after a restart, default is back at
the size the computer boots with.
Errors
Failures raised before the request reaches the computer carryerror alone.
Failures relayed back from the computer add request_id and upstream_status.
Authorizations
Path Parameters
Body
application/json
The new size. Both dimensions are required here, unlike creating a screen. There is no boot screen to fall back to when the intent is an explicit change.
Response
The resized screen. Every other field is unchanged: a resize does not move a screen to another display, and its ports stay where they were.