gcloud beta saas-runtime units update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta saas-runtime units update - update a Unit
- SYNOPSIS
gcloud beta saas-runtime units updateUNIT[--location=LOCATION][--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME][--clear-tenant|--tenant=TENANT][--clear-unit-kind|--unit-kind=UNIT_KIND][--labels=[LABELS,…] |--update-labels=[UPDATE_LABELS,…]--clear-labels|--remove-labels=REMOVE_LABELS][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Update a Unit- EXAMPLES
- To update the Unit, run:
gcloudbetasaas-runtimeunitsupdate - POSITIONAL ARGUMENTS
- Unit resource - Identifier. The resource name (full URI of the resource)following the standard naming scheme:
"projects/{project}/locations/{location}/units/{unit}"ThisrepresentsaCloudresource.(NOTE)Someattributesarenotgivenargumentsinthisgroupbutcanbesetinotherways.
To set the
projectattribute:- provide the argument
uniton the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
uniton the command line with a fullyspecified name; - provide the argument
--locationon the command line.
This must be specified.
UNIT- ID of the unit or fully qualified identifier for the unit.
To set the
unitattribute:- provide the argument
uniton the command line.
- provide the argument
- provide the argument
- Unit resource - Identifier. The resource name (full URI of the resource)following the standard naming scheme:
- FLAGS
--location=LOCATION- For resources [unit, tenant, unit-kind], provides fallback value for resourcelocation attribute. When the resource's full URI path is not provided, locationwill fallback to this flag value.
- Captures requested directives for performing future maintenance on the unit.This includes a request for the unit to skip maintenance for a period of timeand remain pinned to its current release as well as controls for postponingmaintenance scheduled in future.
--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME- If present, it fixes the release on the unit until the given time; i.e. changesto the release field will be rejected. Rollouts should and will also respectthis by not requesting an upgrade in the first place.
- Update tenant.
At most one of these can be specified:
--clear-tenant- Clear tenant value and set to null.
- Tenant resource - Set tenant to new value.
Reference to the Saas Tenant resource this unit belongs to. This for exampleinforms the maintenance policies to use for scheduling future updates on a unit.(optional and immutable once created) This represents a Cloud resource. (NOTE)Some attributes are not given arguments in this group but can be set in otherways.
To set the
projectattribute:- provide the argument
--tenanton the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--tenanton the command line with a fullyspecified name; - provide the argument
--locationon the command line.
--tenant=TENANT- ID of the tenant or fully qualified identifier for the tenant.
To set the
tenantattribute:- provide the argument
--tenanton the command line.
- provide the argument
- provide the argument
- Update unit_kind.
At most one of these can be specified:
--clear-unit-kind- Clear unit_kind value and set to null.
- UnitKind resource - Set unit_kind to new value.
Reference to the UnitKind this Unit belongs to. Immutable once set. Thisrepresents a Cloud resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.
To set the
projectattribute:- provide the argument
--unit-kindon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--unit-kindon the command line with a fullyspecified name; - provide the argument
--locationon the command line.
--unit-kind=UNIT_KIND- ID of the unitKind or fully qualified identifier for the unitKind.
To set the
unit-kindattribute:- provide the argument
--unit-kindon the command line.
- provide the argument
- provide the argument
- Update labels.
At most one of these can be specified:
--labels=[LABELS,…]- Set labels to new value. The labels on the resource, which can be used forcategorization. similar to Kubernetes resource labels.
KEY- Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. 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)
--update-labels=[UPDATE_LABELS,…]- Update labels value or add key value pair. The labels on the resource, which canbe used for categorization. similar to Kubernetes resource labels.
KEY- Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. 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)
- 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 fulldocumentation for this API can be found at:https://cloud.google.com/saas-runtime/docs - NOTES
- This command is currently in beta and might change without notice.
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-10-07 UTC.