v4

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-05-09283767.7 KB

files

Fetch a file into a VM from a presigned URL

Pulls url into the guest at path. url must be a presigned storage URL previously minted by POST /v1/vms/{id}/files/presign (URLs from other sources are rejected).

Response mirrors /v1/vms/{id}/exec: reports stdout/stderr/exit code of the underlying download+unpack operation.

Not idempotent; not retried by default.

post/v1/vms/{id}/files/fetch

Request body

urlstring uri required

Must be the downloadUrl previously returned by POST /v1/vms/{id}/files/presign (URLs from other sources are rejected).

pathstring required

Absolute destination path inside the guest filesystem.

timeoutSecinteger

Per-fetch timeout in seconds.

Response

Fetch completed (command result)

exitCodeinteger required

stdoutstring required

stderrstring required

timedOutboolean required

stdoutTruncatedboolean required

True if the collector dropped stdout bytes past the 4 MiB cap.

stderrTruncatedboolean required

True if the collector dropped stderr bytes past the 4 MiB cap.

durationMsinteger required