- HTTP request
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
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
|
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 } ] } |
Fields | |
---|---|
kind
|
[Output Only] Type of firewallPolicy associations. Always |
associations[]
|
A list of associations. |
associations[].name
|
The name for an association. |
associations[].attachmentTarget
|
The target that the firewall policy is attached to. |
associations[].firewallPolicyId
|
[Output Only] The firewall policy ID of the association. |
associations[].shortName
|
[Output Only] The short name of the firewall policy of the association. |
associations[].displayName
|
[Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association. |
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.firewallPolicies.setFirewallPolicy
To find predefined roles that contain those permissions, see Compute Engine IAM Roles .