gcloud beta run worker-pools update-instance-split Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta run worker-pools update-instance-split - adjust the instance assignments for a Cloud Run worker-pool
- SYNOPSIS
gcloud beta run worker-pools update-instance-split[[WORKER_POOL]--region=REGION][--async][--breakglass=JUSTIFICATION][--to-latest|--to-revisions=[REVISION-NAME=PERCENTAGE,…]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Adjust the instance assignments for a Cloud Run worker-pool.- EXAMPLES
- To assign 10% of instances to revision my-worker-pool-s5sxn and 90% of instancesto revision my-worker-pool-cp9kw run:
gcloudbetarunworker-poolsupdate-instance-splitmy-worker-pool--to-revisions=my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90To increase the instances to revision my-worker-pool-s5sxn to 20% and byreducing the instances to revision my-worker-pool-cp9kw to 80% run:
gcloudbetarunworker-poolsupdate-instance-splitmy-worker-pool--to-revisions=my-worker-pool-s5sxn=20To rollback to revision my-worker-pool-cp9kw run:
gcloudbetarunworker-poolsupdate-instance-splitmy-worker-pool--to-revisions=my-worker-pool-cp9kw=100To assign 100% of instances to the current or future LATEST revision run:
gcloudbetarunworker-poolsupdate-instance-splitmy-worker-pool--to-latestYou can also refer to the current or future LATEST revision in --to-revisions bythe string "LATEST". For example, to set 10% of instances to always float to thelatest revision:
gcloudbetarunworker-poolsupdate-instance-splitmy-worker-pool--to-revisions=LATEST=10 - POSITIONAL ARGUMENTS
- WorkerPool resource - WorkerPool to update instance split of. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
WORKER_POOLon the command line with a fullyspecified name; - specify the workerpool name from an interactive prompt with a fully specifiedname;
- provide the argument
--projecton the command line; - set the property
core/project.
- provide the argument
- [
WORKER_POOL] - ID of the WorkerPool or fully qualified identifier for the WorkerPool.
To set the
worker-poolattribute:- provide the argument
WORKER_POOLon the command line; - specify the workerpool name from an interactive prompt.
- provide the argument
--region=REGION- The Cloud region for the WorkerPool. Overrides the default
run/regionproperty value for this command invocation.To set the
regionattribute:- provide the argument
WORKER_POOLon the command line with a fullyspecified name; - specify the workerpool name from an interactive prompt with a fully specifiedname;
- provide the argument
--regionon the command line; - set the property
run/region; - specify the region from an interactive prompt.
- provide the argument
- WorkerPool resource - WorkerPool to update instance split of. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
- FLAGS
--async- Return immediately, without waiting for the operation in progress to complete.
--breakglass=JUSTIFICATION- Justification to bypass Binary Authorization policy constraints and allow theoperation. Seehttps://cloud.google.com/binary-authorization/docs/using-breakglassfor more information. Next update or deploy command will automatically clearexisting breakglass justification.
- At most one of these can be specified:
--to-latest- True to assign 100 percent of instances to the 'latest' revision of thisservice. Note that when a new revision is created, it will become the 'latest'and instances will be fully assigned to it unless configured otherwise using
--[no-]promoteflag. Defaults to False. Synonymous with'--to-revisions=LATEST=100'. --to-revisions=[REVISION-NAME=PERCENTAGE,…]- Comma separated list of instance assignments in the formREVISION-NAME=PERCENTAGE. REVISION-NAME must be the name for a revision for theworker as returned by 'gcloud run workers revisions list --worker=WORKER' .PERCENTAGE must be an integer percentage between 0 and 100 inclusive. Exworker-nw9hs=10,worker-nw9hs=20 Up to 100 percent of instances may be assigned.If the total of 100 percent of instances is assigned, the Worker instance splitis updated as specified. If under 100 percent of instance split is assigned, theWorker instance split is updated as specified for revisions with assignments andinstance split is scaled up or down proportionally as needed for revision thatare currently serving workload but that do not have new assignments. For exampleassume revision-1 is serving 40 percent of workload and revision-2 is serving 60percent. If revision-1 is assigned 45 percent of instances and no assignment ismade for revision-2, the worker is updated with revsion-1 assigned 45 percent ofinstances and revision-2 scaled down to 55 percent. You can use "LATEST" as aspecial revision name to always put the given percentage of instance split onthe latest ready revision.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. This variantis also available:
gcloudalpharunworker-poolsupdate-instance-split
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-21 UTC.