Enqueue Job
Queues a processing job on a live file. When the file already has an unfinished job of the same kind, returns that job instead of queueing a second one. Errors: KIND_UNKNOWN (no such kind), KIND_NOT_APPLICABLE (the kind does not accept this file type), NOT_FOUND (the file is gone, in the trash or not ready). Needs pipeline.trigger.
Queues a processing job on a live file. When the file already has an unfinished job of the same kind, returns that job instead of queueing a second one. Errors: KIND_UNKNOWN (no such kind), KIND_NOT_APPLICABLE (the kind does not accept this file type), NOT_FOUND (the file is gone, in the trash or not ready). Needs pipeline.trigger.
Arguments
fileId*ID!File id.
kind*String!Job kind, such as shotstash/proxy-720p.
- returns
A processing job on one file.
id*ID!Unique id.
kind*String!The job kind, namespace/name, such as shotstash/proxy-720p.
kindLabel?StringThe stored label of the kind, null when none.
fileId*ID!The file the job processes.
status*String!Stored status: queued, claimed, running, done, failed or cancelled (the last three are final).
state*String!status plus the derived waiting_for_worker (queued while no live worker serves the kind).
progress*Int!Percent done, 0 to 100.
attempts*Int!Attempts made so far.
maxAttempts*Int!Attempts allowed before the job fails.
error?StringLast error (failed jobs, and queued jobs retried after one), null when none.
seq*Int!Grows with every state or progress change; drop events with a lower seq.
outputVersion?The processed version the job produced (done jobs only).
createdAt*DateTime!When the job was queued.
updatedAt*DateTime!When the job last changed.
finishedAt?DateTimeWhen the job reached a final status, null before.
mutation EnqueueJob($fileId: ID!, $kind: String!) { enqueueJob(fileId: $fileId, kind: $kind) { id kind kindLabel fileId status state progress attempts outputVersion { id kind kindLabel mimeType size downloadUrl createdAt } }}Cancel Upload MUTATION
Cancels one of the caller's uploads.
Cancel Job MUTATION
Stops a queued, claimed or running job and returns it cancelled; a worker holding it learns on its next call (409 JOB_TERMINAL). Errors: JOB_TERMINAL when the job already finished (done, failed or cancelled), NOT_FOUND when there is no such job. Needs pipeline.trigger.