- NAME
-
- gcloud preview compute instances ops-agents policies update - update a Google Cloud Observability agents policy for the Ops Agent
- SYNOPSIS
-
-
gcloud preview compute instances ops-agents policies updatePOLICY_ID--file=FILE--zone=ZONE[GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(PREVIEW)gcloud preview compute instances ops-agents policies updatemodifies a policy that facilitates agent management across Compute Engine instances based on user specified instance filters. This policy installs, specifies versioning, and removes Ops Agents.The command returns the content of the modified policy or an error indicating why the modification fails. The modified policy takes effect asynchronously. It can take 10-15 minutes for the VMs to enforce the newly modified policy.
- EXAMPLES
-
To update a Google Cloud Observability agents policy, run:
gcloud preview compute instances ops-agents policies update agent-policy --project=PROJECT --zone=ZONE --file=config.yaml - POSITIONAL ARGUMENTS
-
POLICY_ID-
ID of the policy.
This ID must contain only lowercase letters, numbers, and hyphens, end with a number or a letter, be between 1-63 characters, and be unique within the project.
- REQUIRED FLAGS
-
--file=FILE- YAML file with a subset of agents policy fields you wish to update. For information about the agents policy format, see https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/agent-policies#config-files.
--zone=ZONE- Zone where the agents policy is located.
- 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 DEVELOPER PREVIEW and may change without notice. If
this command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
gcloud compute instances ops-agents policies updategcloud alpha compute instances ops-agents policies updategcloud beta compute instances ops-agents policies update
gcloud preview compute instances ops-agents policies 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-04-14 UTC.