gcloud alpha ai-platform versions update Stay organized with collections Save and categorize content based on your preferences.
- 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 the
projectattribute:- provide the argument
versionon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
VERSION- ID of the version or fully qualified identifier for the version.
To set the
versionattribute:- provide the argument
versionon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--model=MODEL- Model for the version.
To set the
modelattribute:- provide the argument
versionon the command line with a fullyspecified name; - provide the argument
--modelon the command line.
- provide the argument
- provide the argument
- 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.
- 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 as
global.Learn more about regional endpoints and see a list of available regions:https://cloud.google.com/ai-platform/prediction/docs/regional-endpoints
REGIONmust 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-labelsis also specified then--clear-labelsis applied first.For example, to remove all labels:
gcloudalphaai-platformversionsupdate--clear-labelsTo remove all existing labels and create two new labels,
andfoo:bazgcloudalphaai-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-labelsis also specified then--update-labelsis 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 helpfor 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-platformversionsupdategcloudbetaai-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.