- NAME
-
- gcloud compute instances ops-agents policies describe - describe a Google Cloud Observability agents policy for the Ops Agent
- SYNOPSIS
-
-
gcloud compute instances ops-agents policies describePOLICY_ID--zone=ZONE[GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud compute instances ops-agents policies describedescribes 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 one policy. For instance:
agentsRule: packageState: installed version: latest instanceFilter: inclusionLabels: - labels: env: prod
If no policies are found, then the command returns a
NOT_FOUNDerror. - EXAMPLES
-
To describe an agents policy named
ops-agents-test-policyin the current project, run:gcloud compute instances ops-agents policies describe ops-agents-test-policy --zone=ZONE - 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
-
--zone=ZONE- Zone of the agents policy.
- 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
-
These variants are also available:
gcloud alpha compute instances ops-agents policies describegcloud beta compute instances ops-agents policies describe
gcloud compute instances ops-agents policies describe
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 2025-07-22 UTC.