gcloud compute health-checks test-iam-permissions NAME --permissions=[PERMISSION,…] [--global | --region=REGION] [GCLOUD_WIDE_FLAG …]
gcloud compute health-checks test-iam-permissions tests the IAM
permissions that a caller has on a Compute Engine health check.
Note: This operation is designed to be used for building permission-aware UIs
and command-line tools, not for authorization checking. This operation may "fail
open" without warning.
compute.healthChecks.getIamPolicy
permission on a health check my-health-check, run:
gcloud compute health-checks test-iam-permissions my-health-check --permissions=compute.healthChecks.getIamPolicyNAME--permissions=[PERMISSION,…]--global--region=REGION
To avoid prompting when this flag is omitted, you can set the
property:
compute/region
gcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionCLOUDSDK_COMPUTE_REGION.
--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.
gcloud alpha compute health-checks test-iam-permissionsgcloud beta compute health-checks test-iam-permissionsgcloud preview compute health-checks test-iam-permissions
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-07-21 UTC.