.TH "GCLOUD_BETA_SAAS\-RUNTIME_SAAS_UPDATE" 1



.SH "NAME"
.HP
gcloud beta saas\-runtime saas update \- update a SaaS



.SH "SYNOPSIS"
.HP
\f5gcloud beta saas\-runtime saas update\fR (\fISAAS\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-labels\fR=[\fILABELS\fR,...]\ |\ \fB\-\-update\-labels\fR=[\fIUPDATE_LABELS\fR,...]\ \fB\-\-clear\-labels\fR\ |\ \fB\-\-remove\-labels\fR=\fIREMOVE_LABELS\fR] [\fB\-\-locations\fR=[\fIname\fR=\fINAME\fR]\ |\ \fB\-\-add\-locations\fR=[\fIname\fR=\fINAME\fR]\ \fB\-\-clear\-locations\fR\ |\ \fB\-\-remove\-locations\fR=[\fIname\fR=\fINAME\fR]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Update a SaaS



.SH "EXAMPLES"

To update the SaaS, run:

.RS 2m
$ gcloud beta saas\-runtime saas update my\-saas
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Saas resource \- Identifier. The resource name (full URI of the resource)
following the standard naming scheme:

.RS 2m
"projects/{project}/locations/{location}/saas/{saas}" 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.
.RE

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5saas\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
\fISAAS\fR

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

To set the \f5saas\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5saas\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\-\-location\fR=\fILOCATION\fR

Location ID

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


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m

Update labels.

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-labels\fR=[\fILABELS\fR,...]

Set labels to new value. The labels on the resource, which can be used for
categorization. similar to Kubernetes resource labels.

.RS 2m
.TP 2m
\fBKEY\fR
Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers.

.TP 2m
\fBVALUE\fR
Values must contain only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase
characters, and numbers.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-labels=string=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-labels='{"string": "string"}'
.RE


\fBFile Example:\fR


.RS 2m
\-\-labels=path_to_file.(yaml|json)
.RE


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

Update labels value or add key value pair. The labels on the resource, which can
be used for categorization. similar to Kubernetes resource labels.

.RS 2m
.TP 2m
\fBKEY\fR
Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers.

.TP 2m
\fBVALUE\fR
Values must contain only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase
characters, and numbers.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-update\-labels=string=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-update\-labels='{"string": "string"}'
.RE


\fBFile Example:\fR


.RS 2m
\-\-update\-labels=path_to_file.(yaml|json)
.RE


.TP 2m

At most one of these can be specified:


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

Clear labels value and set to empty map.

.TP 2m
\fB\-\-remove\-labels\fR=\fIREMOVE_LABELS\fR

Remove existing value from map labels. Sets \f5remove_labels\fR value.

\fBShorthand Example:\fR


.RS 2m
\-\-remove\-labels=string,string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-remove\-labels=["string"]
.RE


\fBFile Example:\fR


.RS 2m
\-\-remove\-labels=path_to_file.(yaml|json)
.RE


.RE
.RE
.sp
.TP 2m

Update locations.

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-locations\fR=[\fIname\fR=\fINAME\fR]

Set locations to new value. List of locations that the service is available in.
Rollout refers to the list to generate a rollout plan.

.RS 2m
.TP 2m
\fBname\fR
Name of location. Example flag usage: \-\-locations=name=us\-central1.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-locations=name=string \-\-locations=name=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-locations='[{"name": "string"}]'
.RE


\fBFile Example:\fR


.RS 2m
\-\-locations=path_to_file.(yaml|json)
.RE


.TP 2m
\fB\-\-add\-locations\fR=[\fIname\fR=\fINAME\fR]

Add new value to locations list. List of locations that the service is available
in. Rollout refers to the list to generate a rollout plan.

.RS 2m
.TP 2m
\fBname\fR
Name of location. Example flag usage: \-\-locations=name=us\-central1.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-add\-locations=name=string \-\-add\-locations=name=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-add\-locations='[{"name": "string"}]'
.RE


\fBFile Example:\fR


.RS 2m
\-\-add\-locations=path_to_file.(yaml|json)
.RE


.TP 2m

At most one of these can be specified:


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

Clear locations value and set to empty list.

.TP 2m
\fB\-\-remove\-locations\fR=[\fIname\fR=\fINAME\fR]

Remove existing value from locations list. List of locations that the service is
available in. Rollout refers to the list to generate a rollout plan.

.RS 2m
.TP 2m
\fBname\fR
Name of location. Example flag usage: \-\-locations=name=us\-central1.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-remove\-locations=name=string \-\-remove\-locations=name=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-remove\-locations='[{"name": "string"}]'
.RE


\fBFile Example:\fR


.RS 2m
\-\-remove\-locations=path_to_file.(yaml|json)
.RE



.RE
.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 "API REFERENCE"

This command uses the \fBsaasservicemgmt/v1beta1\fR API. The full documentation
for this API can be found at: https://cloud.google.com/saas\-runtime/docs



.SH "NOTES"

This command is currently in beta and might change without notice.