Reference documentation and code samples for the BigQuery Reservation V1 API module Google::Cloud::Bigquery::Reservation::V1::Reservation::ScalingMode.
The scaling mode for the reservation. This enum determines how the
reservation scales up and down.
Constants
SCALING_MODE_UNSPECIFIED
value: 0 Default value of ScalingMode.
AUTOSCALE_ONLY
value: 1 The reservation will scale up only using slots from autoscaling. It will
not use any idle slots even if there may be some available. The upper
limit that autoscaling can scale up to will be max_slots - baseline.
For example, if max_slots is 1000, baseline is 200 and customer sets
ScalingMode to AUTOSCALE_ONLY, then autoscalerg will scale up to 800
slots and no idle slots will be used.
Please note, in this mode, the ignore_idle_slots field must be set to
true.
IDLE_SLOTS_ONLY
value: 2 The reservation will scale up using only idle slots contributed by
other reservations or from unassigned commitments. If no idle slots are
available it will not scale up further. If the idle slots which it is
using are reclaimed by the contributing reservation(s) it may be forced
to scale down. The max idle slots the reservation can be max_slots -
baseline capacity. For example, if max_slots is 1000, baseline is 200 and
customer sets ScalingMode to IDLE_SLOTS_ONLY,
if there are 1000 idle slots available in other reservations, the
reservation will scale up to 1000 slots with 200 baseline and 800 idle
slots.
if there are 500 idle slots available in other reservations, the
reservation will scale up to 700 slots with 200 baseline and 300 idle
slots.
Please note, in this mode, the reservation might not be able to scale up
to max_slots.
Please note, in this mode, the ignore_idle_slots field must be set to
false.
ALL_SLOTS
value: 3 The reservation will scale up using all slots available to it. It will
use idle slots contributed by other reservations or from unassigned
commitments first. If no idle slots are available it will scale up using
autoscaling. For example, if max_slots is 1000, baseline is 200 and
customer sets ScalingMode to ALL_SLOTS,
if there are 800 idle slots available in other reservations, the
reservation will scale up to 1000 slots with 200 baseline and 800 idle
slots.
if there are 500 idle slots available in other reservations, the
reservation will scale up to 1000 slots with 200 baseline, 500 idle
slots and 300 autoscaling slots.
if there are no idle slots available in other reservations, it will
scale up to 1000 slots with 200 baseline and 800 autoscaling slots.
Please note, in this mode, the ignore_idle_slots field must be set to
false.
[[["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-08-28 UTC."],[],[],null,["# BigQuery Reservation V1 API - Module Google::Cloud::Bigquery::Reservation::V1::Reservation::ScalingMode (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-Reservation-ScalingMode)\n- [1.5.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.5.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [1.4.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.4.1/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [1.3.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.3.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [1.2.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.2.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [1.1.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.1.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [1.0.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/1.0.1/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.12.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.12.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.11.2](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.11.2/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.10.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.10.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.9.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.9.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.8.1](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.8.1/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.7.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.7.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.6.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.6.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.5.0](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.5.0/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode)\n- [0.4.2](/ruby/docs/reference/google-cloud-bigquery-reservation-v1/0.4.2/Google-Cloud-Bigquery-Reservation-V1-Reservation-ScalingMode) \nReference documentation and code samples for the BigQuery Reservation V1 API module Google::Cloud::Bigquery::Reservation::V1::Reservation::ScalingMode.\n\nThe scaling mode for the reservation. This enum determines how the\nreservation scales up and down.\n\nConstants\n---------\n\n### SCALING_MODE_UNSPECIFIED\n\n**value:** 0 \nDefault value of ScalingMode.\n\n### AUTOSCALE_ONLY\n\n**value:** 1 \nThe reservation will scale up only using slots from autoscaling. It will\nnot use any idle slots even if there may be some available. The upper\nlimit that autoscaling can scale up to will be max_slots - baseline.\nFor example, if max_slots is 1000, baseline is 200 and customer sets\nScalingMode to AUTOSCALE_ONLY, then autoscalerg will scale up to 800\nslots and no idle slots will be used.\n\n\n\u003cbr /\u003e\n\nPlease note, in this mode, the ignore_idle_slots field must be set to\ntrue.\n\n### IDLE_SLOTS_ONLY\n\n**value:** 2 \nThe reservation will scale up using only idle slots contributed by\nother reservations or from unassigned commitments. If no idle slots are\navailable it will not scale up further. If the idle slots which it is\nusing are reclaimed by the contributing reservation(s) it may be forced\nto scale down. The max idle slots the reservation can be max_slots -\nbaseline capacity. For example, if max_slots is 1000, baseline is 200 and\ncustomer sets ScalingMode to IDLE_SLOTS_ONLY,\n\n\n1. if there are 1000 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline and 800 idle slots.\n2. if there are 500 idle slots available in other reservations, the reservation will scale up to 700 slots with 200 baseline and 300 idle slots. Please note, in this mode, the reservation might not be able to scale up to max_slots.\n\n\u003cbr /\u003e\n\nPlease note, in this mode, the ignore_idle_slots field must be set to\nfalse.\n\n### ALL_SLOTS\n\n**value:** 3 \nThe reservation will scale up using all slots available to it. It will\nuse idle slots contributed by other reservations or from unassigned\ncommitments first. If no idle slots are available it will scale up using\nautoscaling. For example, if max_slots is 1000, baseline is 200 and\ncustomer sets ScalingMode to ALL_SLOTS,\n\n\n1. if there are 800 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline and 800 idle slots.\n2. if there are 500 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline, 500 idle slots and 300 autoscaling slots.\n3. if there are no idle slots available in other reservations, it will scale up to 1000 slots with 200 baseline and 800 autoscaling slots.\n\n\u003cbr /\u003e\n\nPlease note, in this mode, the ignore_idle_slots field must be set to\nfalse."]]