Sign in

v1

latestOpenAPI 3.1.0MIT Licence2026-07-17613573.4 KB
Batches API v1Alpha

Get signed URL for job log

Returns a time-limited GCS signed URL for direct download of a job's container log. The URL is valid for 15 minutes from the time of issue. Range requests are supported, so parallel download tools work correctly as long as all streams are initiated within the validity window. Only available for completed jobs (or a specific past attempt via attempt_id). Only available for GCP deployments using GCS logs. The signed URL is returned without first verifying the log file exists in GCS; callers should handle a 404 from GCS if the log was never written (e.g. preempted job).

get/api/v1alpha/batches/{batch_id}/jobs/{job_id}/log/{container}/signed_url

Path parameters

batch_idnumber required

The ID of the batch.

job_idnumber required

The ID of the job.

containerstring required

The name of the container.

Query parameters

attempt_idstring

Return the signed URL for a specific attempt. Defaults to the most recent attempt.

Response

Successfully generated a signed URL for the log.

signed_urlstring required

A GCS signed URL for direct download of the log. Valid until expires_at.

expires_atstring date-time required

ISO 8601 timestamp at which the signed URL expires.