Sign in
files

Fetch a file into a VM from a presigned URL

Scheduler asks the VM worker to download 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 — the worker runs the fetch via the guest agent and 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
stderrTruncatedboolean required
durationMsinteger required

Changes