.TH "GCLOUD_ALPHA_AI\-PLATFORM_VERSIONS_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha ai\-platform versions update \- update an AI Platform version



.SH "SYNOPSIS"
.HP
\f5gcloud alpha ai\-platform versions update\fR (\fIVERSION\fR\ :\ \fB\-\-model\fR=\fIMODEL\fR) [\fB\-\-config\fR=\fIYAML_FILE\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-update\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-bigquery\-table\-name\fR=\fIBIGQUERY_TABLE_NAME\fR\ \fB\-\-sampling\-percentage\fR=\fISAMPLING_PERCENTAGE\fR] [\fB\-\-clear\-labels\fR\ |\ \fB\-\-remove\-labels\fR=[\fIKEY\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update an AI Platform version.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Version resource \- The AI Platform model to update. The arguments in this group
can be used to specify the attributes of this resource. (NOTE) Some attributes
are not given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5version\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIVERSION\fR

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

To set the \f5version\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5version\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-model\fR=\fIMODEL\fR

Model for the version.

To set the \f5model\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5version\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-model\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-config\fR=\fIYAML_FILE\fR

Path to a YAML configuration file containing configuration parameters for the
version (https://cloud.google.com/ml/reference/rest/v1/projects.models.versions)
to create.

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

.RS 2m
description: A free\-form description of the version.
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.
.RE

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

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

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

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

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Description of the version.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Google Cloud region of the regional endpoint to use for this command. For the
global endpoint, the region needs to be specified as \f5global\fR.

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

\fIREGION\fR must be one of: \fBglobal\fR, \fBasia\-east1\fR,
\fBasia\-northeast1\fR, \fBasia\-southeast1\fR, \fBaustralia\-southeast1\fR,
\fBeurope\-west1\fR, \fBeurope\-west2\fR, \fBeurope\-west3\fR,
\fBeurope\-west4\fR, \fBnorthamerica\-northeast1\fR, \fBus\-central1\fR,
\fBus\-east1\fR, \fBus\-east4\fR, \fBus\-west1\fR.

.TP 2m
\fB\-\-update\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to update. If a label exists, its value is
modified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m

Configure request response logging.


.RS 2m
.TP 2m
\fB\-\-bigquery\-table\-name\fR=\fIBIGQUERY_TABLE_NAME\fR

Fully qualified name (project_id.dataset_name.table_name) of the BigQuery table
where requests and responses are logged.

.TP 2m
\fB\-\-sampling\-percentage\fR=\fISAMPLING_PERCENTAGE\fR

Percentage of requests to be logged, expressed as a number between 0 and 1. For
example, set this value to 1 in order to log all requests or to 0.1 to log 10%
of requests.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-labels\fR

Remove all labels. If \f5\-\-update\-labels\fR is also specified then
\f5\-\-clear\-labels\fR is applied first.

For example, to remove all labels:

.RS 2m
$ gcloud alpha ai\-platform versions update \-\-clear\-labels
.RE

To remove all existing labels and create two new labels, \f5\fIfoo\fR\fR and
\f5\fIbaz\fR\fR:

.RS 2m
$ gcloud alpha ai\-platform versions update \-\-clear\-labels \e
  \-\-update\-labels foo=bar,baz=qux
.RE

.TP 2m
\fB\-\-remove\-labels\fR=[\fIKEY\fR,...]

List of label keys to remove. If a label does not exist it is silently ignored.
If \f5\-\-update\-labels\fR is also specified then \f5\-\-update\-labels\fR is
applied first.


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "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. These variants are also available:

.RS 2m
$ gcloud ai\-platform versions update
.RE

.RS 2m
$ gcloud beta ai\-platform versions update
.RE