gcloud beta compute instances ops-agents policies describe

NAME
gcloud beta compute instances ops-agents policies describe - describe a Google Cloud's operations suite agents(Ops Agents) policy
SYNOPSIS
gcloud beta compute instances ops-agents policies describePOLICY_ID[GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA)gcloud beta compute instances ops-agents policiesdescribe describes a policy that facilitates agent management acrossCompute Engine instances based on user specified instance filters. This policyinstalls, specifies versioning, enables autoupgrade, and removes Ops Agents.

The command returns the content of one policy. For instance:

agent_rules:-enable_autoupgrade:truepackage_state:installedtype:ops-agentversion:latestassignment:group_labels:-app:myappenv:prodos_types:-short_name:ubuntuversion:'18.04'zones:-us-central1-acreate_time:'2021-02-02T02:10:25.344Z'description:Atestpolicytoinstallagentsetag:<ETAG>id:projects/<PROJECT_NUMBER>/guestPolicies/ops-agents-test-policyupdate_time:'2021-02-02T02:10:25.344Z'

If no policies are found, it returns aNOT_FOUND error.

EXAMPLES
To describe an Ops Agents policy namedops-agents-test-policy in the currentproject, run:
gcloudbetacomputeinstancesops-agentspoliciesdescribeops-agents-test-policy
POSITIONAL ARGUMENTS
POLICY_ID
ID of the policy.

This ID must start withops-agents-,contain only lowercase letters, numbers, and hyphens, end with a number or aletter, be between 1-63 characters, and be unique within the project. The goalof the prefixops-agents- is to easilydistinguish these Ops Agents specific policies from other generic policies andlower the chance of naming conflicts.

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. Thesevariants are also available:
gcloudcomputeinstancesops-agentspoliciesdescribe
gcloudalphacomputeinstancesops-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.