Firewall Policy Rule Collection Groups - Get
Gets the specified FirewallPolicyRuleCollectionGroup.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/firewallPolicies/{firewallPolicyName}/ruleCollectionGroups/{ruleCollectionGroupName}?api-version=2025-03-01
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
firewall
|
path | True |
string |
The name of the Firewall Policy. |
|
resource
|
path | True |
string |
The name of the resource group. |
|
rule
|
path | True |
string |
The name of the FirewallPolicyRuleCollectionGroup. |
|
subscription
|
path | True |
string |
The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
|
api-version
|
query | True |
string |
Client API version. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Request successful. The operation returns a FirewallPolicyRuleCollectionGroup resource. |
|
| Other Status Codes |
Error response describing why the operation failed. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name | Description |
|---|---|
| user_impersonation | impersonate your user account |
Examples
|
Get Firewall |
|
Get Firewall |
|
Get Firewall |
|
Get Firewall |
Get FirewallPolicyNatRuleCollectionGroup
Sample request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1?api-version=2025-03-01
Sample response
{
"name": "ruleCollectionGroup1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1",
"etag": "W/\"72090554-7e3b-43f2-80ad-99a9020dcb11\"",
"properties": {
"provisioningState": "Succeeded",
"priority": 100,
"ruleCollections": [
{
"ruleCollectionType": "FirewallPolicyNatRuleCollection",
"action": {
"type": "DNAT"
},
"rules": [
{
"ruleType": "NatRule",
"name": "NatRule1",
"translatedFqdn": "internalhttpserver",
"translatedPort": "8080",
"ipProtocols": [
"TCP",
"UDP"
],
"sourceAddresses": [
"2.2.2.2"
],
"sourceIpGroups": [],
"destinationAddresses": [
"152.23.32.23"
],
"destinationPorts": [
"8080"
]
}
],
"name": "NatRC",
"priority": 100
}
]
}
}
Get FirewallPolicyRuleCollectionGroup
Sample request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1?api-version=2025-03-01
Sample response
{
"name": "ruleCollectionGroup1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1",
"etag": "W/\"72090554-7e3b-43f2-80ad-99a9020dcb11\"",
"properties": {
"size": "1.2MB",
"provisioningState": "Succeeded",
"priority": 110,
"ruleCollections": [
{
"ruleCollectionType": "FirewallPolicyFilterRuleCollection",
"name": "Example-Filter-Rule-Collection",
"priority": 200,
"action": {
"type": "Deny"
},
"rules": [
{
"ruleType": "NetworkRule",
"name": "network-rule1",
"sourceAddresses": [
"10.1.25.0/24"
],
"destinationAddresses": [
"*"
],
"ipProtocols": [
"TCP"
],
"destinationPorts": [
"*"
]
}
]
}
]
}
}
Get FirewallPolicyRuleCollectionGroup With IpGroups
Sample request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleGroup1?api-version=2025-03-01
Sample response
{
"name": "ruleGroup1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleGroups/ruleGroup1",
"etag": "W/\"72090554-7e3b-43f2-80ad-99a9020dcb11\"",
"properties": {
"provisioningState": "Succeeded",
"priority": 110,
"ruleCollections": [
{
"ruleCollectionType": "FirewallPolicyFilterRuleCollection",
"name": "Example-Filter-Rule-Collection",
"priority": 200,
"action": {
"type": "Deny"
},
"rules": [
{
"ruleType": "NetworkRule",
"name": "network-rule1",
"ipProtocols": [
"TCP"
],
"destinationPorts": [
"*"
],
"sourceIpGroups": [
"/subscriptions/subid/providers/Microsoft.Network/resourceGroup/rg1/ipGroups/ipGroups1"
],
"destinationIpGroups": [
"/subscriptions/subid/providers/Microsoft.Network/resourceGroup/rg1/ipGroups/ipGroups2"
]
}
]
}
]
}
}
Get FirewallPolicyRuleCollectionGroup With Web Categories
Sample request
GET https://management.azure.com/subscriptions/e747cc13-97d4-4a79-b463-42d7f4e558f2/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1?api-version=2025-03-01
Sample response
{
"name": "ruleCollectionGroup1",
"id": "/subscriptions/e747cc13-97d4-4a79-b463-42d7f4e558f2/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1",
"etag": "W/\"72090554-7e3b-43f2-80ad-99a9020dcb11\"",
"properties": {
"provisioningState": "Succeeded",
"priority": 110,
"ruleCollections": [
{
"ruleCollectionType": "FirewallPolicyFilterRuleCollection",
"name": "Example-Filter-Rule-Collection",
"priority": 200,
"action": {
"type": "Deny"
},
"rules": [
{
"ruleType": "ApplicationRule",
"name": "rule1",
"description": "Deny inbound rule",
"protocols": [
{
"protocolType": "Https",
"port": 443
}
],
"sourceAddresses": [
"216.58.216.164",
"10.0.0.0/24"
],
"webCategories": [
"Hacking"
]
}
]
}
]
}
}
Definitions
| Name | Description |
|---|---|
|
Application |
Rule of type application. |
|
Cloud |
An error response from the service. |
|
Cloud |
An error response from the service. |
|
Firewall |
Firewall Policy Filter Rule Collection. |
|
Firewall |
Properties of the FirewallPolicyFilterRuleCollectionAction. |
|
Firewall |
The action type of a rule. |
|
Firewall |
name and value of HTTP/S header to insert |
|
Firewall |
Firewall Policy NAT Rule Collection. |
|
Firewall |
Properties of the FirewallPolicyNatRuleCollectionAction. |
|
Firewall |
The action type of a rule. |
|
Firewall |
Properties of the application rule protocol. |
|
Firewall |
The application protocol type of a Rule. |
|
Firewall |
Rule Collection Group resource. |
|
Firewall |
The Network protocol of a Rule. |
|
Nat |
Rule of type nat. |
|
Network |
Rule of type network. |
|
Provisioning |
The current provisioning state. |
ApplicationRule
Rule of type application.
| Name | Type | Description |
|---|---|---|
| description |
string |
Description of the rule. |
| destinationAddresses |
string[] |
List of destination IP addresses or Service Tags. |
| fqdnTags |
string[] |
List of FQDN Tags for this rule. |
| httpHeadersToInsert |
List of HTTP/S headers to insert. |
|
| name |
string |
Name of the rule. |
| protocols |
Array of Application Protocols. |
|
| ruleType | string: |
Rule Type. |
| sourceAddresses |
string[] |
List of source IP addresses for this rule. |
| sourceIpGroups |
string[] |
List of source IpGroups for this rule. |
| targetFqdns |
string[] |
List of FQDNs for this rule. |
| targetUrls |
string[] |
List of Urls for this rule condition. |
| terminateTLS |
boolean |
Terminate TLS connections for this rule. |
| webCategories |
string[] |
List of destination azure web categories. |
CloudError
An error response from the service.
| Name | Type | Description |
|---|---|---|
| error |
Cloud error body. |
CloudErrorBody
An error response from the service.
| Name | Type | Description |
|---|---|---|
| code |
string |
An identifier for the error. Codes are invariant and are intended to be consumed programmatically. |
| details |
A list of additional details about the error. |
|
| message |
string |
A message describing the error, intended to be suitable for display in a user interface. |
| target |
string |
The target of the particular error. For example, the name of the property in error. |
FirewallPolicyFilterRuleCollection
Firewall Policy Filter Rule Collection.
| Name | Type | Description |
|---|---|---|
| action |
The action type of a Filter rule collection. |
|
| name |
string |
The name of the rule collection. |
| priority |
integer (int32) minimum: 100maximum: 65000 exclusiveMinimum: False exclusiveMaximum: False |
Priority of the Firewall Policy Rule Collection resource. |
| ruleCollectionType | string: |
The type of the rule collection. |
| rules | FirewallPolicyRule[]: |
List of rules included in a rule collection. |
FirewallPolicyFilterRuleCollectionAction
Properties of the FirewallPolicyFilterRuleCollectionAction.
| Name | Type | Description |
|---|---|---|
| type |
The type of action. |
FirewallPolicyFilterRuleCollectionActionType
The action type of a rule.
| Value | Description |
|---|---|
| Allow | |
| Deny |
FirewallPolicyHttpHeaderToInsert
name and value of HTTP/S header to insert
| Name | Type | Description |
|---|---|---|
| headerName |
string |
Contains the name of the header |
| headerValue |
string |
Contains the value of the header |
FirewallPolicyNatRuleCollection
Firewall Policy NAT Rule Collection.
| Name | Type | Description |
|---|---|---|
| action |
The action type of a Nat rule collection. |
|
| name |
string |
The name of the rule collection. |
| priority |
integer (int32) minimum: 100maximum: 65000 exclusiveMinimum: False exclusiveMaximum: False |
Priority of the Firewall Policy Rule Collection resource. |
| ruleCollectionType | string: |
The type of the rule collection. |
| rules | FirewallPolicyRule[]: |
List of rules included in a rule collection. |
FirewallPolicyNatRuleCollectionAction
Properties of the FirewallPolicyNatRuleCollectionAction.
| Name | Type | Description |
|---|---|---|
| type |
The type of action. |
FirewallPolicyNatRuleCollectionActionType
The action type of a rule.
| Value | Description |
|---|---|
| DNAT |
FirewallPolicyRuleApplicationProtocol
Properties of the application rule protocol.
| Name | Type | Description |
|---|---|---|
| port |
integer (int32) minimum: 0maximum: 64000 exclusiveMinimum: False exclusiveMaximum: False |
Port number for the protocol, cannot be greater than 64000. |
| protocolType |
Protocol type. |
FirewallPolicyRuleApplicationProtocolType
The application protocol type of a Rule.
| Value | Description |
|---|---|
| Http | |
| Https |
FirewallPolicyRuleCollectionGroup
Rule Collection Group resource.
| Name | Type | Description |
|---|---|---|
| etag |
string |
A unique read-only string that changes whenever the resource is updated. |
| id |
string |
Resource ID. |
| name |
string |
The name of the resource that is unique within a resource group. This name can be used to access the resource. |
| properties.priority |
integer (int32) minimum: 100maximum: 65000 exclusiveMinimum: False exclusiveMaximum: False |
Priority of the Firewall Policy Rule Collection Group resource. |
| properties.provisioningState |
The provisioning state of the firewall policy rule collection group resource. |
|
| properties.ruleCollections | FirewallPolicyRuleCollection[]: |
Group of Firewall Policy rule collections. |
| properties.size |
string |
A read-only string that represents the size of the FirewallPolicyRuleCollectionGroupProperties in MB. (ex 1.2MB) |
| type |
string |
Rule Group type. |
FirewallPolicyRuleNetworkProtocol
The Network protocol of a Rule.
| Value | Description |
|---|---|
| TCP | |
| UDP | |
| Any | |
| ICMP |
NatRule
Rule of type nat.
| Name | Type | Description |
|---|---|---|
| description |
string |
Description of the rule. |
| destinationAddresses |
string[] |
List of destination IP addresses or Service Tags. |
| destinationPorts |
string[] |
List of destination ports. |
| ipProtocols |
Array of FirewallPolicyRuleNetworkProtocols. |
|
| name |
string |
Name of the rule. |
| ruleType | string: |
Rule Type. |
| sourceAddresses |
string[] |
List of source IP addresses for this rule. |
| sourceIpGroups |
string[] |
List of source IpGroups for this rule. |
| translatedAddress |
string |
The translated address for this NAT rule. |
| translatedFqdn |
string |
The translated FQDN for this NAT rule. |
| translatedPort |
string |
The translated port for this NAT rule. |
NetworkRule
Rule of type network.
| Name | Type | Description |
|---|---|---|
| description |
string |
Description of the rule. |
| destinationAddresses |
string[] |
List of destination IP addresses or Service Tags. |
| destinationFqdns |
string[] |
List of destination FQDNs. |
| destinationIpGroups |
string[] |
List of destination IpGroups for this rule. |
| destinationPorts |
string[] |
List of destination ports. |
| ipProtocols |
Array of FirewallPolicyRuleNetworkProtocols. |
|
| name |
string |
Name of the rule. |
| ruleType | string: |
Rule Type. |
| sourceAddresses |
string[] |
List of source IP addresses for this rule. |
| sourceIpGroups |
string[] |
List of source IpGroups for this rule. |
ProvisioningState
The current provisioning state.
| Value | Description |
|---|---|
| Succeeded | |
| Updating | |
| Deleting | |
| Failed |