Method: firewallPolicies.listAssociations

Lists associations of a specified target, i.e., organization or folder.

HTTP request

GET https://compute.googleapis.com/compute/beta/locations/global/firewallPolicies/listAssociations

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
targetResource

string

The target resource to list associations. It is an organization, or a folder.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation
 { 
 "kind" 
 : 
 string 
 , 
 "associations" 
 : 
 [ 
 { 
 "name" 
 : 
 string 
 , 
 "attachmentTarget" 
 : 
 string 
 , 
 "firewallPolicyId" 
 : 
 string 
 , 
 "shortName" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "priority" 
 : 
 integer 
 } 
 ] 
 } 
Fields
kind

string

[Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations.

associations[]

object

A list of associations.

associations[].name

string

The name for an association.

associations[].attachmentTarget

string

The target that the firewall policy is attached to.

associations[].firewallPolicyId

string

[Output Only] The firewall policy ID of the association.

associations[].shortName

string

[Output Only] The short name of the firewall policy of the association.

associations[].displayName
(deprecated)

string

[Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association.

associations[].priority

integer

An integer indicating the priority of an association. The priority must be a positive value between 1 and 2147483647. Firewall Policies are evaluated from highest to lowest priority where 1 is the highest priority and 2147483647 is the lowest priority. The default value is 1000 . If two associations have the same priority then lexicographical order on association names is applied.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/compute.readonly
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview .

IAM Permissions

In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:

  • compute.organizations.listAssociations
  • compute.organizations.setFirewallPolicy

To find predefined roles that contain those permissions, see Compute Engine IAM Roles .

Create a Mobile Website
View Site in Mobile | Classic
Share by: