Method: firewallPolicies.listAssociations

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

HTTP request

GET https://compute.googleapis.com/compute/v1/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
    }
  ]
}
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.

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.