- NAME
-
- gcloud beta app-lifecycle-manager units update - update a unit
- SYNOPSIS
-
-
gcloud beta app-lifecycle-manager units updateUNIT[--location=LOCATION] [--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME] [--application=APPLICATION|--clear-application] [--clear-tenant|--tenant=TENANT] [--clear-unit-kind|--unit-kind=UNIT_KIND] [--flag-revisions=[FLAG_REVISIONS,…] |--add-flag-revisions=[ADD_FLAG_REVISIONS,…]--clear-flag-revisions|--remove-flag-revisions=[REMOVE_FLAG_REVISIONS,…]] [--labels=[LABELS,…] |--update-labels=[UPDATE_LABELS,…]--clear-labels|--remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Update an App Lifecycle Manager unit. - EXAMPLES
-
To add or update the label
env=prodon the unit namedmy-unitin locationus-central1, run:gcloud beta app-lifecycle-manager units update my-unit --location=us-central1 --update-labels=env=prodTo pin the current release of the unit named
my-unituntil the end of 2099, run:gcloud beta app-lifecycle-manager units update my-unit --location=us-central1 --maintenance-pinned-until-time=2099-12-31T23:59:59Z - POSITIONAL ARGUMENTS
-
-
Unit resource - Unit to update. This represents a Cloud 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
uniton the command line with a fully specified 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 fully specified 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 - Unit to update. This represents a Cloud resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
- FLAGS
-
--location=LOCATION- For resources [unit, flag-revisions, tenant, unit-kind], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value.
- Requested directives for performing future maintenance on the unit. These directives include a request for the unit to skip maintenance for a period of time and remain pinned to its current release. They also include controls for postponing scheduled maintenance.
--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME- Time until which the release of the unit is pinned. Until this time, changes to the release of the unit are rejected, and rollouts do not request an upgrade of the unit.
-
Update application.
At most one of these can be specified:
--application=APPLICATION- Set application to new value.
--clear-application- Clear application value and set to null.
-
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.
Tenant that this unit belongs to. For example, the tenant informs the maintenance policies to use for scheduling future updates on the unit. The tenant is optional and cannot be changed after the unit is created. This represents a Cloud 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
--tenanton the command line with a fully specified 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 fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--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
-
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.
Unit kind that this unit belongs to. The unit kind cannot be changed after it is set. This represents a Cloud 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
--unit-kindon the command line with a fully specified 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 fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--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
-
Update flag_revisions.
At most one of these can be specified:
-
FlagRevision resource - Set flag_revisions to new value.
Flag revisions used by this unit. This represents a Cloud 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
--flag-revisionson the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
--flag-revisionson the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--flag-revisions=[FLAG_REVISIONS,…]-
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.
To set the
flag-revisionattribute:-
provide the argument
--flag-revisionson the command line.
-
provide the argument
-
FlagRevision resource - Add new value to flag_revisions list.
Flag revisions used by this unit. This represents a Cloud 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
--add-flag-revisionson the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
--add-flag-revisionson the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--add-flag-revisions=[ADD_FLAG_REVISIONS,…]-
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.
To set the
flag-revisionattribute:-
provide the argument
--add-flag-revisionson the command line.
-
provide the argument
-
At most one of these can be specified:
--clear-flag-revisions- Clear flag_revisions value and set to empty list.
-
Or at least one of these can be specified:
-
FlagRevision resource - Remove value from flag_revisions list.
Flag revisions used by this unit. This represents a Cloud 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
--remove-flag-revisionson the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
--remove-flag-revisionson the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--remove-flag-revisions=[REMOVE_FLAG_REVISIONS,…]-
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.
To set the
flag-revisionattribute:-
provide the argument
--remove-flag-revisionson the command line.
-
provide the argument
-
FlagRevision resource - Remove value from flag_revisions list.
-
FlagRevision resource - Set flag_revisions to new 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)
- 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 units 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."],[],[]]