batch_results
Creates, updates, deletes, gets or lists a batch_results resource.
Overview
| Name | batch_results |
| Type | Resource |
| Id | digitalocean.inference.batch_results |
Fields
The following fields are returned by SELECT queries:
- inference_get_batch_results
Presigned download URLs.
| Name | Datatype | Description |
|---|---|---|
batch_id | string (uuid) | (example: 0e9d1d35-3d1e-4d66-9a2f-8c7e0f6b3e21) |
error_file_url | string (uri) | Presigned URL for the error sidecar JSONL, if any. |
expires_at | string (date-time) | When the presigned URLs expire. (example: 2026-04-24T20:19:19Z) |
output_file_url | string (uri) | Presigned URL for the main results JSONL. (example: https://batch-inference.nyc3.digitaloceanspaces.com/outputs/0e9d1d35-3d1e-4d66-9a2f-8c7e0f6b3e21.jsonl?X-Amz-Signature=...) |
result_available | boolean | When false, keep polling batch status and retry later. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
inference_get_batch_results | select | batch_id | Returns short-lived presigned download URLs for the output (and optional error sidecar) of a completed batch job. If results are not yet ready, the response sets result_available: false or returns 412 Precondition Failed; in both cases, keep polling batch status and retry.Download the artifacts soon after fetching — the URLs are short-lived. Result files themselves are retained for up to 30 days after the job completes, after which they are deleted. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
batch_id | string (uuid) | The batch job identifier. (example: 0e9d1d35-3d1e-4d66-9a2f-8c7e0f6b3e21) |
SELECT examples
- inference_get_batch_results
Returns short-lived presigned download URLs for the output (and optional error sidecar) of a completed batch job. If results are not yet ready, the response sets result_available: false or returns 412 Precondition Failed; in both cases, keep polling batch status and retry.
Download the artifacts soon after fetching — the URLs are short-lived. Result files themselves are retained for up to 30 days after the job completes, after which they are deleted.
SELECT
batch_id,
error_file_url,
expires_at,
output_file_url,
result_available
FROM digitalocean.inference.batch_results
WHERE batch_id = '{{ batch_id }}' -- required
;