Method: projects.locations.reservations.delete
Deletes a reservation. Returns google.rpc.Code.FAILED_PRECONDITION when reservation has assignments.
HTTP request
DELETE https://bigqueryreservation.googleapis.com/v1/{name=projects/*/locations/*/reservations/*}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. Resource name of the reservation to retrieve. E.g., projects/myproject/locations/US/reservations/team1-prod
Authorization requires the following IAM permission on the specified resource name:
bigquery.reservations.delete
|
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/bigqueryhttps://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["\u003cp\u003eThis page documents the process for deleting a reservation using an HTTP DELETE request to the BigQuery Reservation API.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL follows gRPC Transcoding syntax and requires a \u003ccode\u003ename\u003c/code\u003e path parameter specifying the reservation to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and upon successful deletion, the response body will be an empty JSON object.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a reservation requires \u003ccode\u003ebigquery.reservations.delete\u003c/code\u003e IAM permission on the specified reservation resource, and will return an error if there are any active assignments.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this request requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
