gcloud compute instances ops-agents policies describe

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 describe describes apolicy that facilitates agent management across Compute Engine instances basedon 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:installedversion:latestinstanceFilter:inclusionLabels:-labels:env:prod

If no policies are found, then the command returns aNOT_FOUNDerror.

EXAMPLES
To describe an agents policy namedops-agents-test-policy in thecurrent project, run:
gcloudcomputeinstancesops-agentspoliciesdescribeops-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 anumber or a letter, be between 1-63 characters, and be unique within theproject.

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 help for details.

NOTES
These variants are also available:
gcloudalphacomputeinstancesops-agentspoliciesdescribe
gcloudbetacomputeinstancesops-agentspoliciesdescribe

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-07-22 UTC.