- NAME
-
- gcloud beta compute firewall-policies test-iam-permissions - test IAM permissions for a Compute Engine organization firewall policy
- SYNOPSIS
-
-
gcloud beta compute firewall-policies test-iam-permissionsFIREWALL_POLICY--permissions=[PERMISSION,…] [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Returns permissions that a caller has on the specified organization firewall policy. - EXAMPLES
-
To test if the caller has
compute.firewallPolicies.getpermission on the organization firewall policymy-policy(under organization123456789), run:gcloud beta compute firewall-policies test-iam-permissions my-policy --organization=123456789 --permissions=compute.firewallPolicies.getTo test if the caller has
compute.firewallPolicies.getpermission on the organization firewall policy with numeric ID987654321, run:gcloud beta compute firewall-policies test-iam-permissions 987654321 --permissions=compute.firewallPolicies.get - POSITIONAL ARGUMENTS
-
FIREWALL_POLICY- Short name or ID of the firewall policy to test IAM permissions.
- REQUIRED FLAGS
-
--permissions=[PERMISSION,…]- The permissions to test.
- OPTIONAL FLAGS
-
--organization=ORGANIZATION- Organization ID in which the organization firewall policy is to be described. Must be set if FIREWALL_POLICY is short name.
- 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
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud compute firewall-policies test-iam-permissionsgcloud alpha compute firewall-policies test-iam-permissionsgcloud preview compute firewall-policies test-iam-permissions
gcloud beta compute firewall-policies 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-08-11 UTC.