gcloud alpha ai-platform versions update

NAME
gcloud alpha ai-platform versions update - update an AI Platform version
SYNOPSIS
gcloud alpha ai-platform versions update(VERSION :--model=MODEL)[--config=YAML_FILE][--description=DESCRIPTION][--region=REGION][--update-labels=[KEY=VALUE,…]][--bigquery-table-name=BIGQUERY_TABLE_NAME--sampling-percentage=SAMPLING_PERCENTAGE][--clear-labels    |--remove-labels=[KEY,…]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Update an AI Platform version.
POSITIONAL ARGUMENTS
Version resource - The AI Platform model to update. The arguments in this groupcan be used to specify the attributes of this resource. (NOTE) Some attributesare not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentversion on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

VERSION
ID of the version or fully qualified identifier for the version.

To set theversion attribute:

  • provide the argumentversion on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--model=MODEL
Model for the version.

To set themodel attribute:

  • provide the argumentversion on the command line with a fullyspecified name;
  • provide the argument--model on the command line.
FLAGS
--config=YAML_FILE
Path to a YAML configuration file containing configuration parameters for theversionto create.

The file is in YAML format. Note that not all attributes of a version areconfigurable; available attributes (with example values) are:

description:Afree-formdescriptionoftheversion.manualScaling:nodes:10# The number of nodes to allocate for this model.autoScaling:minNodes:0# The minimum number of nodes to allocate for this model.maxNodes:1# The maxinum number of nodes to allocate for this model.requestLoggingconfig:bigqueryTableName:someTable# Fully qualified BigQuery table name.samplingPercentage:0.5# Percentage of requests to be logged.

The name of the version must always be specified via the required VERSIONargument.

Only one of manualScaling or autoScaling can be specified. If both are specifiedin same yaml file, an error will be returned.

Labels cannot currently be set in the config.yaml; please use the command-lineflags to alter them.

If an option is specified both in the configuration file and via command-linearguments, the command-line arguments override the configuration file.

--description=DESCRIPTION
Description of the version.
--region=REGION
Google Cloud region of the regional endpoint to use for this command. For theglobal endpoint, the region needs to be specified asglobal.

Learn more about regional endpoints and see a list of available regions:https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints

REGION must be one of:global,asia-east1,asia-northeast1,asia-southeast1,australia-southeast1,europe-west1,europe-west2,europe-west3,europe-west4,northamerica-northeast1,us-central1,us-east1,us-east4,us-west1.

--update-labels=[KEY=VALUE,…]
List of label KEY=VALUE pairs to update. If a label exists, its value ismodified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers.

Configure request response logging.
--bigquery-table-name=BIGQUERY_TABLE_NAME
Fully qualified name (project_id.dataset_name.table_name) of the BigQuery tablewhere requests and responses are logged.
--sampling-percentage=SAMPLING_PERCENTAGE
Percentage of requests to be logged, expressed as a number between 0 and 1. Forexample, set this value to 1 in order to log all requests or to 0.1 to log 10%of requests.
At most one of these can be specified:
--clear-labels
Remove all labels. If--update-labels is also specified then--clear-labels is applied first.

For example, to remove all labels:

gcloudalphaai-platformversionsupdate--clear-labels

To remove all existing labels and create two new labels,foo andbaz:

gcloudalphaai-platformversionsupdate--clear-labels--update-labelsfoo=bar,baz=qux
--remove-labels=[KEY,…]
List of label keys to remove. If a label does not exist it is silently ignored.If--update-labels is also specified then--update-labels is applied first.
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 thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudai-platformversionsupdate
gcloudbetaai-platformversionsupdate

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 2025-07-22 UTC.