gcloud beta compute firewall-policies list Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta compute firewall-policies list - list Compute Engine organization firewall policies
- SYNOPSIS
gcloud beta compute firewall-policies list[NAME…](--folder=FOLDER|--organization=ORGANIZATION)[--regexp=REGEXP,-rREGEXP][--filter=EXPRESSION][--limit=LIMIT][--page-size=PAGE_SIZE][--sort-by=[FIELD,…]][--uri][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)gcloud beta compute firewall-policies listisused to list organization firewall policies. An organization firewall policy isa set of rules that controls access to various resources.- EXAMPLES
- To list organization firewall policies under folder with ID ``123456789", run:
gcloudbetacomputefirewall-policieslist--folder=123456789 - POSITIONAL ARGUMENTS
- [
NAME…] - (DEPRECATED) If provided, show details for the specified names and/or URIs ofresources.
Argument
NAMEis deprecated. Use--filter="name=( 'NAME'… )"instead.
- [
- REQUIRED FLAGS
- Exactly one of these must be specified:
--folder=FOLDER- Folder in which firewall policies are listed
--organization=ORGANIZATION- Organization in which firewall policies are listed
- Exactly one of these must be specified:
- FLAGS
--regexp=REGEXP,-rREGEXP- (DEPRECATED) Regular expression to filter the names of the results on. Any namesthat do not match the entire regular expression will be filtered out.
Flag
--regexpis deprecated. Use--filter="name~'REGEXP'"instead.
- LIST COMMAND FLAGS
--filter=EXPRESSION- Apply a Boolean filter
EXPRESSIONto each resource itemto be listed. If the expression evaluatesTrue, then that item islisted. For more details and examples of filter expressions, run $gcloud topic filters. This flaginteracts 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. Thisflag 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 themaximum number of resources per page. The default is determined by the serviceif it supports paging, otherwise it is
unlimited(no paging).Paging may be applied before or after--filterand--limitdepending on the service. --sort-by=[FIELD,…]- Comma-separated list of resource field key names to sort by. The default orderis ascending. Prefix a field with ``~´´ for descending order on thatfield. This flag interacts with other flags that are applied in this order:
--flatten,--sort-by,--filter,--limit. --uri- Print a list of resource URIs instead of the default output, and change thecommand output to a list of URIs. If this flag is used with
--format, the formatting is applied on this URI list. To displayURIs alongside other keys instead, use theuri()transform.
- 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. - IAM PERMISSIONS
- To list firewall policies, the user must have the following permission:
compute.firewallPolicies.list.To find predefined roles that contain those permissions, see theCompute Engine IAMroles.
- NOTES
- This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudcomputefirewall-policieslistgcloudalphacomputefirewall-policieslist
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-05-07 UTC.