projects

PATCH /v1/projects/{projectsId}/locations/{locationsId}/biReservation

Changed on Nov 3, 2026

Updates a BI reservation. Only fields specified in the field_mask are updated. A singleton BI reservation always exists with default size 0. In order to reserve BI capacity it needs to be updated to an amount greater than 0. In order to release BI capacity reservation size must be set to 0.

Request

Base URL
https://bigqueryreservation.googleapis.com
URL
https://bigqueryreservation.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/biReservation
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/bigquery
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/bigquery
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/cloud-platform
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform

Path parameters

projectsIdstring required

locationsIdstring required

Query parameters

updateMaskstring google-fieldmask

A list of fields to be updated in this request.

Request body

namestring

Identifier. The resource name of the singleton BI reservation. Reservation names have the form projects/{project_id}/locations/{location_id}/biReservation.

sizestring int64

Optional. Size of a reservation, in bytes.

updateTimestring google-datetime

Output only. The last update timestamp of a reservation.

Response

Successful response