Method: projects.locations.capacityCommitments.delete

Deletes a capacity commitment. Attempting to delete capacity commitment before its commitmentEndTime will fail with the error code google.rpc.Code.FAILED_PRECONDITION.

HTTP request

DELETE https://bigqueryreservation.googleapis.com/v1/{name=projects/*/locations/*/capacityCommitments/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123

Authorization requires the following IAM permission on the specified resource name:

  • bigquery.capacityCommitments.delete

Query parameters

Parameters
force

boolean

Can be used to force delete commitments even if assignments exist. Deleting commitments with assignments may cause queries to fail if they no longer have access to slots.

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

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 the Authentication Overview.