- NAME
-
- gcloud beta app-lifecycle-manager saas update - update a SaaS offering
- SYNOPSIS
-
-
gcloud beta app-lifecycle-manager saas update(SAAS:--location=LOCATION) [--application-template=APPLICATION_TEMPLATE--application-template-revision=APPLICATION_TEMPLATE_REVISION--clear-application-template] [--labels=[LABELS,…] |--update-labels=[UPDATE_LABELS,…]--clear-labels|--remove-labels=REMOVE_LABELS] [--locations=[name=NAME] |--add-locations=[name=NAME]--clear-locations|--remove-locations=[name=NAME]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Update an App Lifecycle Manager SaaS offering. - EXAMPLES
-
To add or update the label
env=prodon the SaaS offering namedmy-saasin locationus-central1, run:gcloud beta app-lifecycle-manager saas update my-saas --location=us-central1 --update-labels=env=prodTo make the SaaS offering named
my-saasalso available ineurope-west1and remove the labelenv, run:gcloud beta app-lifecycle-manager saas update my-saas --location=us-central1 --add-locations=name=europe-west1 --remove-labels=env - POSITIONAL ARGUMENTS
-
-
Saas resource - SaaS offering 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
projectattribute:-
provide the argument
saason the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
This must be specified.
SAAS-
ID of the saas or fully qualified identifier for the saas.
To set the
saasattribute:-
provide the argument
saason the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--location=LOCATION-
Location ID
To set the
locationattribute:-
provide the argument
saason the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
-
provide the argument
-
Saas resource - SaaS offering 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.
- FLAGS
-
- Composite application template. Specify only in source regions; leave unspecified in replica regions. When specified, the template components are imported into their equivalent unit kind, release, and blueprint resources. Deleting the reference does not delete imported resources.
--application-template=APPLICATION_TEMPLATE- Full resource name of the Application Design Center composite application template to import.
--application-template-revision=APPLICATION_TEMPLATE_REVISION- Revision of the application template to use. Changes to the revision trigger manual resynchronization. If empty, the application template is ignored.
--clear-application-template- Set saas.applicationTemplate back to default value.
-
Update labels.
At most one of these can be specified:
--labels=[LABELS,…]-
Set labels to new value. Labels on the resource, which can be used for
categorization, similar to Kubernetes resource labels.
KEY-
Keys must start with a lowercase character and contain only hyphens
(
-), underscores (_), lowercase characters, and numbers. VALUE-
Values must contain only hyphens (
-), underscores (_), lowercase characters, and numbers.
Shorthand Example:--labels=string=string
JSON Example:--labels='{"string": "string"}'
File Example:--labels=path_to_file.(yaml|json)
-
Or at least one of these can be specified:
--update-labels=[UPDATE_LABELS,…]-
Update labels value or add key value pair. Labels on the resource, which can be
used for categorization, similar to Kubernetes resource labels.
KEY-
Keys must start with a lowercase character and contain only hyphens
(
-), underscores (_), lowercase characters, and numbers. VALUE-
Values must contain only hyphens (
-), underscores (_), lowercase characters, and numbers.
Shorthand Example:--update-labels=string=string
JSON Example:--update-labels='{"string": "string"}'
File Example:--update-labels=path_to_file.(yaml|json)
-
At most one of these can be specified:
--clear-labels- Clear labels value and set to empty map.
--remove-labels=REMOVE_LABELS-
Remove existing value from map labels. Sets
remove_labelsvalue.Shorthand Example:--remove-labels=string,stringJSON Example:--remove-labels=["string"]
File Example:--remove-labels=path_to_file.(yaml|json)
-
Update locations.
At most one of these can be specified:
--locations=[name=NAME]-
Set locations to new value. Locations in which the SaaS offering is available.
Rollouts use this list to generate a rollout plan. Repeat the flag to specify
multiple locations.
name- Name of the location.
Shorthand Example:--locations=name=string --locations=name=string
JSON Example:--locations='[{"name": "string"}]'
File Example:--locations=path_to_file.(yaml|json)
-
Or at least one of these can be specified:
--add-locations=[name=NAME]-
Add new value to locations list. Locations in which the SaaS offering is
available. Rollouts use this list to generate a rollout plan. Repeat the flag to
specify multiple locations.
name- Name of the location.
Shorthand Example:--add-locations=name=string --add-locations=name=string
JSON Example:--add-locations='[{"name": "string"}]'
File Example:--add-locations=path_to_file.(yaml|json)
-
At most one of these can be specified:
--clear-locations- Clear locations value and set to empty list.
--remove-locations=[name=NAME]-
Remove existing value from locations list. Locations in which the SaaS offering
is available. Rollouts use this list to generate a rollout plan. Repeat the flag
to specify multiple locations.
name- Name of the location.
Shorthand Example:--remove-locations=name=string --remove-locations=name=string
JSON Example:--remove-locations='[{"name": "string"}]'
File Example:--remove-locations=path_to_file.(yaml|json)
- 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. - API REFERENCE
-
This command uses the
saasservicemgmt/v1beta1API. The full documentation for this API can be found at: https://docs.cloud.google.com/app-lifecycle-manager - NOTES
- This command is currently in beta and might change without notice.
gcloud beta app-lifecycle-manager saas update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-27 UTC.
[null,null,["Last updated 2026-10-27 UTC."],[],[]]