1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00
gcloud-help/gcloud/ml-engine/versions/update
2023-05-04 10:43:54 +00:00

136 lines
5.1 KiB
Text

NAME
gcloud ml-engine versions update - update an AI Platform version
SYNOPSIS
gcloud ml-engine versions update (VERSION : --model=MODEL)
[--config=YAML_FILE] [--description=DESCRIPTION] [--region=REGION]
[--update-labels=[KEY=VALUE,...]]
[--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Update an AI Platform version.
POSITIONAL ARGUMENTS
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 project attribute:
◆ provide the argument version on the command line with a fully
specified name;
◆ provide the argument --project on 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 version attribute:
▸ provide the argument version on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--model=MODEL
Model for the version.
To set the model attribute:
▸ provide the argument version on the command line with a fully
specified name;
▸ provide the argument --model on the command line.
FLAGS
--config=YAML_FILE
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:
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.
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.
--description=DESCRIPTION
Description of the version.
--region=REGION
Google Cloud region of the regional endpoint to use for this command.
For the global 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
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
is modified. Otherwise, a new label is created.
Keys must start with a lowercase character and contain only hyphens
(-), underscores (_), lowercase characters, and numbers. Values must
contain only hyphens (-), underscores (_), lowercase characters, and
numbers.
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:
$ gcloud ml-engine versions update --clear-labels
To remove all existing labels and create two new labels, foo and baz:
$ gcloud ml-engine versions update --clear-labels \
--update-labels foo=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
These variants are also available:
$ gcloud alpha ml-engine versions update
$ gcloud beta ml-engine versions update