cancel_job#

ElasticTranscoder.Client.cancel_job(**kwargs)#

The CancelJob operation cancels an unfinished job.

Note

You can only cancel a job that has a status of Submitted. To prevent a pipeline from starting to process a job while you’re getting the job identifier, use UpdatePipelineStatus to temporarily pause the pipeline.

Request Syntax

response = client.cancel_job(
    Id='string'
)

Parameters:

Id (string) –

[REQUIRED]

The identifier of the job that you want to cancel.

To get a list of the jobs (including their jobId) that have a status of Submitted, use the ListJobsByStatus API action.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

(dict) –

The response body contains a JSON object. If the job is successfully canceled, the value of Success is true.

Exceptions

ElasticTranscoder.Client.exceptions.ValidationException
ElasticTranscoder.Client.exceptions.IncompatibleVersionException
ElasticTranscoder.Client.exceptions.ResourceNotFoundException
ElasticTranscoder.Client.exceptions.ResourceInUseException
ElasticTranscoder.Client.exceptions.AccessDeniedException
ElasticTranscoder.Client.exceptions.InternalServiceException