gcloud-help/gcloud/alpha/run/workers/update-instance-split

NAME
    gcloud alpha run workers update-instance-split - adjust the instance
        assignments for a Cloud Run worker

SYNOPSIS
    gcloud alpha run workers update-instance-split [WORKER] [--async]
        [--breakglass=JUSTIFICATION] [--region=REGION]
        [--to-latest | --to-revisions=[REVISION-NAME=PERCENTAGE,...]]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Adjust the instance assignments for a Cloud Run worker.

EXAMPLES
    To assign 10% of instances to revision my-worker-s5sxn and 90% of instances
    to revision my-worker-cp9kw run:

        $ gcloud alpha run workers update-instance-split my-worker \
          --to-revisions=my-worker-s5sxn=10,my-worker-cp9kw=90

    To increase the instances to revision my-worker-s5sxn to 20% and by
    reducing the instances to revision my-worker-cp9kw to 80% run:

        $ gcloud alpha run workers update-instance-split my-worker \
          --to-revisions=my-worker-s5sxn=20

    To rollback to revision my-worker-cp9kw run:

        $ gcloud alpha run workers update-instance-split my-worker \
          --to-revisions=my-worker-cp9kw=100

    To assign 100% of instances to the current or future LATEST revision run:

        $ gcloud alpha run workers update-instance-split my-worker \
          --to-latest

    You can also refer to the current or future LATEST revision in
    --to-revisions by the string "LATEST". For example, to set 10% of instances
    to always float to the latest revision:

        $ gcloud alpha run workers update-instance-split my-worker \
          --to-revisions=LATEST=10

POSITIONAL ARGUMENTS
     Worker resource - Worker to update instance split of. This represents a
     Cloud resource. (NOTE) Some attributes are not given arguments in this
     group but can be set in other ways.

     To set the project attribute:
      ◆ provide the argument WORKER on the command line with a fully
        specified name;
      ◆ specify the worker name from an interactive prompt with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

       [WORKER]
          ID of the worker or fully qualified identifier for the worker.

          To set the worker attribute:
          ▸ provide the argument WORKER on the command line;
          ▸ specify the worker name from an interactive prompt.

FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --breakglass=JUSTIFICATION
        Justification to bypass Binary Authorization policy constraints and
        allow the operation. See
        https://cloud.google.com/binary-authorization/docs/using-breakglass for
        more information. Next update or deploy command will automatically
        clear existing breakglass justification.

     --region=REGION
        Region in which the resource can be found. Alternatively, set the
        property [run/region].

     At most one of these can be specified:

       --to-latest
          True to assign 100 percent of instances to the 'latest' revision of
          this service. 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-]promote flag. Defaults to False.
          Synonymous with '--to-revisions=LATEST=100'.

       --to-revisions=[REVISION-NAME=PERCENTAGE,...]
          Comma separated list of instance assignments in the form
          REVISION-NAME=PERCENTAGE. REVISION-NAME must be the name for a
          revision for the worker as returned by 'gcloud run workers revisions
          list --worker=WORKER' . PERCENTAGE must be an integer percentage
          between 0 and 100 inclusive. Ex worker-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 split is updated as
          specified. If under 100 percent of instance split is assigned, the
          Worker instance split is updated as specified for revisions with
          assignments and instance split is scaled up or down proportionally as
          needed for revision that are currently serving workload but that do
          not have new assignments. For example assume revision-1 is serving 40
          percent of workload and revision-2 is serving 60 percent. If
          revision-1 is assigned 45 percent of instances and no assignment is
          made for revision-2, the worker is updated with revsion-1 assigned 45
          percent of instances and revision-2 scaled down to 55 percent. You
          can use "LATEST" as a special revision name to always put the given
          percentage of instance split on the 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 help for details.

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist.