Reference documentation and code samples for the BigQuery Reservation V1 API module Google::Cloud::Bigquery::Reservation::V1::ReservationService.
This API allows users to manage their BigQuery reservations.
A reservation provides computational resource guarantees, in the form of
slots, to users. A slot is a
unit of computational power in BigQuery, and serves as the basic unit of
parallelism. In a scan of a multi-partitioned table, a single slot operates
on a single partition of the table. A reservation resource exists as a child
resource of the admin project and location, e.g.:
projects/myproject/locations/US/reservations/reservationName.
A capacity commitment is a way to purchase compute capacity for BigQuery jobs
(in the form of slots) with some committed period of usage. A capacity
commitment resource exists as a child resource of the admin project and
location, e.g.:
projects/myproject/locations/US/capacityCommitments/id.
To load this service and instantiate a REST client:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-09 UTC."],[],[],null,["# BigQuery Reservation V1 API - Module Google::Cloud::Bigquery::Reservation::V1::ReservationService (v1.6.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.6.0 (latest)](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/latest/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.5.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.5.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.4.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.4.1/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.3.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.3.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.2.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.2.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.1.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.1.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [1.0.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.0.1/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.12.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.12.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.11.2](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.11.2/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.10.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.10.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.9.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.9.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.8.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.8.1/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.7.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.7.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.6.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.6.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.5.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.5.0/Google-Cloud-Bigquery-Reservation-V1-ReservationService)\n- [0.4.2](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.4.2/Google-Cloud-Bigquery-Reservation-V1-ReservationService) \nReference documentation and code samples for the BigQuery Reservation V1 API module Google::Cloud::Bigquery::Reservation::V1::ReservationService.\n\nThis API allows users to manage their BigQuery reservations.\n\nA reservation provides computational resource guarantees, in the form of\n[slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a\nunit of computational power in BigQuery, and serves as the basic unit of\nparallelism. In a scan of a multi-partitioned table, a single slot operates\non a single partition of the table. A reservation resource exists as a child\nresource of the admin project and location, e.g.:\n`projects/myproject/locations/US/reservations/reservationName`.\n\nA capacity commitment is a way to purchase compute capacity for BigQuery jobs\n(in the form of slots) with some committed period of usage. A capacity\ncommitment resource exists as a child resource of the admin project and\nlocation, e.g.:\n`projects/myproject/locations/US/capacityCommitments/id`.\n\nTo load this service and instantiate a REST client: \n\n require \"google/cloud/bigquery/reservation/v1/reservation_service/rest\"\n client = ::Google::Cloud::Bigquery::Reservation::V1::ReservationService::Rest::Client.new"]]