- INFORMATION
-
gcloud beta assured workloads updateis not available in universe domainuniverse. - NAME
-
- gcloud beta assured workloads update - update Assured Workloads environments
- SYNOPSIS
-
-
gcloud beta assured workloads update(WORKLOAD:--location=LOCATION--organization=ORGANIZATION) [--async] [--etag=ETAG] [--version=VERSION; default="v1"] [--display-name=DISPLAY_NAME--labels=[KEY=VALUE,…]--violation-notifications-enabled=VIOLATION_NOTIFICATIONS_ENABLED] [--framework-major-revision=FRAMEWORK_MAJOR_REVISION--cloud-control-config=[PROPERTY=VALUE,…] |--cloud-control-configs-from-file=CLOUD_CONTROL_CONFIGS_FROM_FILE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Update a given Assured Workloads environment. - EXAMPLES
-
To update the display name and labels of a V1 Assured Workload using a full
resource name:
gcloud beta assured workloads update organizations/123/locations/us-central1/workloads/456 --display-name=Test-Workload-2 --labels=dept=sec,env=prod --etag=789To update a V1 Assured Workload using discrete resource flags:
gcloud beta assured workloads update 456 --organization=123 --location=us-central1 --display-name=Test-Workload-2 --etag=789To update the major revision and cloud control configurations of a V2 Assured Workload using a full resource name:
gcloud beta assured workloads update organizations/123/locations/us-central1/workloads/456 --framework-major-revision=2 --cloud-control-configs-from-file=/path/to/controls.yaml --version=v2To update the major revision and cloud control configurations of a V2 Assured Workload using discrete resource flags:
gcloud beta assured workloads update 456 --organization=123 --location=us-central1 --framework-major-revision=2 --cloud-control-configs-from-file=/path/to/controls.yaml --version=v2To update cloud control configurations from a file for a V2 Assured Workload:
gcloud beta assured workloads update 456 --organization=123 --location=us-central1 --cloud-control-configs-from-file=/path/to/controls.yaml --version=v2To update a V2 Assured Workload asynchronously:
gcloud beta assured workloads update 456 --organization=123 --location=us-central1 --framework-major-revision=2 --cloud-control-configs-from-file=/path/to/controls.yaml --async --version=v2 - POSITIONAL ARGUMENTS
-
-
Workload resource - The Assured Workloads environment resource to update. The
arguments in this group can be used to specify the attributes of this resource.
This must be specified.
WORKLOAD-
ID of the workload or fully qualified identifier for the workload.
To set the
workloadattribute:-
provide the argument
workloadon 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-
The location for the workload.
To set the
locationattribute:-
provide the argument
workloadon the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--organization=ORGANIZATION-
The parent organization for the workload.
To set the
organizationattribute:-
provide the argument
workloadon the command line with a fully specified name; -
provide the argument
--organizationon the command line.
-
provide the argument
-
Workload resource - The Assured Workloads environment resource to update. The
arguments in this group can be used to specify the attributes of this resource.
- FLAGS
-
--async- Return immediately, without waiting for the operation in progress to complete.
--etag=ETAG- The etag acquired by reading the Assured Workloads environment before updating.
--version=VERSION; default="v1"-
Assured Workloads API version to use. Options are v1 and v2. Defaults to v1.
VERSIONmust be one of:v1,v2.
- V1 UPDATE FLAGS
-
- Settings that can be updated on the Assured Workloads environment.
--display-name=DISPLAY_NAME- The new display name of the Assured Workloads environment (V1).
--labels=[KEY=VALUE,…]- The new labels of the Assured Workloads environment, for example, LabelKey1=LabelValue1,LabelKey2=LabelValue2 (V1).
--violation-notifications-enabled=VIOLATION_NOTIFICATIONS_ENABLED- The notification setting of the Assured Workloads environment (V1).
- V2 UPDATE FLAGS
-
--framework-major-revision=FRAMEWORK_MAJOR_REVISION- Updated major revision ID for the workload (V2).
-
At most one of these can be specified:
--cloud-control-config=[PROPERTY=VALUE,…]- Updated repeated inline control configuration (V2).
--cloud-control-configs-from-file=CLOUD_CONTROL_CONFIGS_FROM_FILE- Path to JSON/YAML file specifying updated control configurations (V2).
- 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. - NOTES
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud assured workloads updategcloud alpha assured workloads update
gcloud beta assured workloads 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-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-13 UTC."],[],[]]