gcloud beta compute zone-vm-extension-policies update Stay organized with collections Save and categorize content based on your preferences.
- 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 the
property isn't set, you mightbe prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloudconfigsetcompute/zoneZONEA list of zones can be fetched by running:
gcloudcomputezoneslistTo unset the property, run:
gcloudconfigunsetcompute/zoneAlternatively, the zone can be stored in the environment variable
.CLOUDSDK_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 helpfor 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.