Method: jobs.cancel

Requests that a job be cancelled. This call will return immediately, and the client will need to poll for the job status to see if the cancel completed successfully. Cancelled jobs may still incur costs.

HTTP request

POST https://bigquery.googleapis.com/bigquery/v2/projects/{projectId}/jobs/{jobId}/cancel

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. Project ID of the job to cancel

jobId

string

Required. Job ID of the job to cancel

Query parameters

Parameters
location

string

The geographic location of the job. You mustspecify the location to run the job for the following scenarios:

  • If the location to run a job is not in theus or theeu multi-regional location
  • If the job's location is in a single region (for example,us-central1)

Request body

The request body must be empty.

Response body

Describes format of a jobs cancellation response.

If successful, the response body contains data with the following structure:

JSON representation
{"kind":string,"job":{object (Job)}}
Fields
kind

string

The resource type of the response.

job

object (Job)

The final state of the job.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-02 UTC.