projects

POST /v1/projects/{projectsId}/locations/{locationsId}/reservationGroups

Changed on Nov 3, 2026

Creates a new reservation group.

Request

Base URL
https://bigqueryreservation.googleapis.com
URL
https://bigqueryreservation.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/reservationGroups
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

reservationGroupIdstring

Required. The reservation group ID. It must only contain lower case alphanumeric characters or dashes. It must start with a letter and must not end with a dash. Its maximum length is 64 characters.

Request body

creationTimestring google-datetime

Output only. Creation time of the reservation group.

namestring

Identifier. The resource name of the reservation group, e.g., projects/*/locations/*/reservationGroups/team1-prod. The reservation_group_id must only contain lower case alphanumeric characters or dashes. It must start with a letter and must not end with a dash. Its maximum length is 64 characters.

parentGroupstring

Optional. The parent reservation group of the reservation group. Format: projects/*/locations/*/reservationGroups/team1-prod for non-root reservation groups, or projects/*/locations/* for root reservation groups.

updateTimestring google-datetime

Output only. Last update time of the reservation group via a user operation. This timestamp is updated only when an update operation explicitly targets this reservation group directly. It is not updated when parent or child groups are created, updated, or deleted.

Response

Successful response