gcloud compute os-config os-policy-assignment-reports list

NAME
gcloud compute os-config os-policy-assignment-reports list - list OS policy assignment reports
SYNOPSIS
gcloud compute os-config os-policy-assignment-reports list [--endpoint-mode=ENDPOINT_MODE] [--location=LOCATION] [--assignment-id=ASSIGNMENT_ID     | --instance=INSTANCE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,…]] [GCLOUD_WIDE_FLAG]
DESCRIPTION
List OS policy assignment reports.
EXAMPLES
To list reports OS policy assignment in location us-central1-a:
gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a

To list reports of an instance my-instance in location us-central1-a:

gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a --instance=my-instance

To list reports of an OS policy assignment my-assignment in location us-central1-a:

gcloud compute os-config os-policy-assignment-reports list --location=us-central1-a --assignment-id=my-assignment
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide enhanced data residency and reliability by ensuring your request is handled entirely within the specified Google Cloud region. This differs from global endpoints, which may process parts of the request outside the target region. Overrides the default regional/endpoint_mode property value for this command invocation. ENDPOINT_MODE must be one of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global endpoints. Recommended for most users.
Location resource - Location of the OS policy assignment reports to list. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument --location on the command line with a fully specified name;
  • set the property compute/zone with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.
--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set the location attribute:

  • provide the argument --location on the command line;
  • set the property compute/zone.
Specify which instance or OS policy assignment to list reports for.

At most one of these can be specified:

--assignment-id=ASSIGNMENT_ID
An OSPolicyAssignment ID. If not provided, OSPolicyAssignmentReports for all instances in the project and location will be listed.
--instance=INSTANCE
Either instance name or instance ID. If not provided, OSPolicyAssignmentReports for all instances in the project and location will be listed.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed. If the expression evaluates True, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag specifies the maximum number of resources per page. The default is determined by the service if it supports paging, otherwise it is unlimited (no paging). Paging may be applied before or after --filter and --limit depending on the service.
--sort-by=[FIELD,…]
Comma-separated list of resource field key names to sort by. The default order is ascending. Prefix a field with ``~´´ for descending order on that field. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.
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.

API REFERENCE
This command uses the osconfig/v1 API. The full documentation for this API can be found at: https://cloud.google.com/compute/docs/osconfig/rest
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for this command, use the --endpoint-mode=regional-preferred flag. To use regional endpoints by default, run $ gcloud config set regional/endpoint_mode regional-preferred.
NOTES
This variant is also available:
gcloud alpha compute os-config os-policy-assignment-reports list