gcloud beta compute zone-vm-extension-policies update

NAME
gcloud beta compute zone-vm-extension-policies update - update a Compute Engine zone VM extension policy
SYNOPSIS
gcloud beta compute zone-vm-extension-policies updateNAME--extensions=EXTENSION_NAME,[…][--config=KEY=VALUE,[KEY=VALUE,…]][--config-from-file=KEY=FILE_PATH,[…]][--description=DESCRIPTION][--inclusion-labels=INCLUSION_LABELS][--priority=PRIORITY; default=1000][--version=KEY=VALUE,[KEY=VALUE,…]][--zone=ZONE][GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Update a Compute Engine zone VM extension policy.
EXAMPLES
To update a zone VM extension policy, run:
gcloudbetacomputezone-vm-extension-policiesupdatetest-policy-name--description="test policy"--extensions=extension1,extension2--version=extension1=version1,extension2=version2--config=extension1="config1",extension2="config2"--inclusion-labels=env=prod--inclusion-labels=env=preprod,workload=load-test--priority=1000
POSITIONAL ARGUMENTS
NAME
Name of the zone vm extension policy to update.
REQUIRED FLAGS
--extensions=EXTENSION_NAME,[…]
One or more extensions to be added to the policy.
OPTIONAL FLAGS
--config=KEY=VALUE,[KEY=VALUE,…]
A comma separated key:value list where the key is the extension name and thevalue is the desired config for the given extension. The extension name must beone of the extensions specified in the --extensions flag.

E.g. --config=filestore='filestore config',ops-agent='ops agent config'

Raises: ArgumentTypeError: If the extension name is not specified in the--extensions flag.

--config-from-file=KEY=FILE_PATH,[…]
Same as --config except that the value for the entry will be read from a localfile. The extension name must be one of the extensions specified in the--extensions flag.

It is an error to specify the same extension in both --config and--config-from-file.

--description=DESCRIPTION
An optional text description for the extension policy.
--inclusion-labels=INCLUSION_LABELS
A list of inclusion labels to select the target VMs.

The expected format for a single selector is "key1=value1,key2=value2". A VM isselected if it has ALL the inclusion labels.

When the option is specified multiple times, it assumes a logical OR between theselectors.

For example, if the inclusion labels are ["env=prod,workload=frontend","workload=backend"], the following VMs will be selected:

  • VM1: env=prod, workload=frontend, something=else
  • VM2: env=prod, workload=backend But not:
  • VM3: env=prod

If not specified, ALL VMs in the zone will be selected.

--priority=PRIORITY; default=1000
The priority of the policy. Lower the number, higher the priority. When twopolicies try to apply the same extension to a VM, the policy with higherpriority takes precedence. If the priorities are the same, the policy with themore recent update timestamp takes precedence. If a policy is deleted, theextension remains installed on the VM if a lower-priority policy still applies.

Range from 0 to 65535. Default is 1000.

--version=KEY=VALUE,[KEY=VALUE,…]
A comma separated key:value list where the key is the extension name and thevalue is the desired version for the given extension. The extension name must beone of the extensions specified in the --extensions flag. If no version isspecified for an extension, the latest version will be used and will be upgradedautomatically.

E.g. --version=filestore=123ABC,ops-agent=456DEF

Raises: ArgumentTypeError: If the extension name is not specified in the--extensions flag.

--zone=ZONE
Zone of the zone vm extension policy to update. If not specified and thecompute/zone property isn't set, you mightbe prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_COMPUTE_ZONE.

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.

NOTES
This command is currently in beta and might change without notice. This variantis also available:
gcloudalphacomputezone-vm-extension-policiesupdate

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-12-16 UTC.