gcloud beta app-lifecycle-manager units update

NAME
gcloud beta app-lifecycle-manager units update - update a unit
SYNOPSIS
gcloud beta app-lifecycle-manager units update UNIT [--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=prod on the unit named my-unit in location us-central1, run:
gcloud beta app-lifecycle-manager units update my-unit --location=us-central1 --update-labels=env=prod

To pin the current release of the unit named my-unit until 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 project attribute:

  • provide the argument unit on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument unit on the command line with a fully specified name;
  • provide the argument --location on the command line.

This must be specified.

UNIT
ID of the unit or fully qualified identifier for the unit.

To set the unit attribute:

  • provide the argument unit on the command line.
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 project attribute:

  • provide the argument --tenant on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --tenant on the command line with a fully specified name;
  • provide the argument --location on the command line.
--tenant=TENANT
ID of the tenant or fully qualified identifier for the tenant.

To set the tenant attribute:

  • provide the argument --tenant on the command line.
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 project attribute:

  • provide the argument --unit-kind on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --unit-kind on the command line with a fully specified name;
  • provide the argument --location on the command line.
--unit-kind=UNIT_KIND
ID of the unitKind or fully qualified identifier for the unitKind.

To set the unit-kind attribute:

  • provide the argument --unit-kind on the command line.
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 project attribute:

  • provide the argument --flag-revisions on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --flag-revisions on the command line with a fully specified name;
  • provide the argument --location on the command line.
--flag-revisions=[FLAG_REVISIONS,…]
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.

To set the flag-revision attribute:

  • provide the argument --flag-revisions on the command line.
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 project attribute:

  • provide the argument --add-flag-revisions on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --add-flag-revisions on the command line with a fully specified name;
  • provide the argument --location on the command line.
--add-flag-revisions=[ADD_FLAG_REVISIONS,…]
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.

To set the flag-revision attribute:

  • provide the argument --add-flag-revisions on the command line.
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 project attribute:

  • provide the argument --remove-flag-revisions on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --remove-flag-revisions on the command line with a fully specified name;
  • provide the argument --location on the command line.
--remove-flag-revisions=[REMOVE_FLAG_REVISIONS,…]
IDs of the flagRevisions or fully qualified identifiers for the flagRevisions.

To set the flag-revision attribute:

  • provide the argument --remove-flag-revisions on the command line.
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_labels value. Shorthand Example:
--remove-labels=string,string

JSON 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 help for details.

API REFERENCE
This command uses the saasservicemgmt/v1beta1 API. 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.