Firewall Policy Rule Collection Groups - Get

Ottiene l'oggetto FirewallPolicyRuleCollectionGroup specificato.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/firewallPolicies/{firewallPolicyName}/ruleCollectionGroups/{ruleCollectionGroupName}?api-version=2023-09-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
firewallPolicyName
path True

string

Nome del criterio firewall.

resourceGroupName
path True

string

Nome del gruppo di risorse.

ruleCollectionGroupName
path True

string

Nome del firewallPolicyRuleCollectionGroup.

subscriptionId
path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True

string

Versione API client.

Risposte

Nome Tipo Descrizione
200 OK

FirewallPolicyRuleCollectionGroup

Richiesta riuscita. L'operazione restituisce una risorsa FirewallPolicyRuleCollectionGroup.

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get FirewallPolicyNatRuleCollectionGroup
Get FirewallPolicyRuleCollectionGroup
Get FirewallPolicyRuleCollectionGroup With IpGroups
Get FirewallPolicyRuleCollectionGroup With Web Categories

Get FirewallPolicyNatRuleCollectionGroup

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/firewallPolicies/firewallPolicy/ruleCollectionGroups/ruleCollectionGroup1?api-version=2023-09-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=2023-09-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=2023-09-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=2023-09-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"
            ]
          }
        ]
      }
    ]
  }
}

Definizioni

Nome Descrizione
ApplicationRule

Regola dell'applicazione di tipo.

CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

FirewallPolicyFilterRuleCollection

Raccolta regole filtro criteri firewall.

FirewallPolicyFilterRuleCollectionAction

Proprietà di FirewallPolicyFilterRuleCollectionAction.

FirewallPolicyFilterRuleCollectionActionType

Tipo di azione di una regola.

FirewallPolicyHttpHeaderToInsert

nome e valore dell'intestazione HTTP/S da inserire

FirewallPolicyNatRuleCollection

Raccolta regole NAT dei criteri del firewall.

FirewallPolicyNatRuleCollectionAction

Proprietà del firewallPolicyNatRuleCollectionAction.

FirewallPolicyNatRuleCollectionActionType

Tipo di azione di una regola.

FirewallPolicyRuleApplicationProtocol

Proprietà del protocollo della regola dell'applicazione.

FirewallPolicyRuleApplicationProtocolType

Tipo di protocollo dell'applicazione di una regola.

FirewallPolicyRuleCollectionGroup

Risorsa Gruppo di raccolta regole.

FirewallPolicyRuleNetworkProtocol

Protocollo di rete di una regola.

NatRule

Regola di tipo nat.

NetworkRule

Regola di rete di tipo.

ProvisioningState

Stato di provisioning corrente.

ApplicationRule

Regola dell'applicazione di tipo.

Nome Tipo Descrizione
description

string

Descrizione della regola.

destinationAddresses

string[]

Elenco di indirizzi IP di destinazione o tag di servizio.

fqdnTags

string[]

Elenco di tag FQDN per questa regola.

httpHeadersToInsert

FirewallPolicyHttpHeaderToInsert[]

Elenco di intestazioni HTTP/S da inserire.

name

string

Nome della regola.

protocols

FirewallPolicyRuleApplicationProtocol[]

Matrice di protocolli applicazione.

ruleType string:

ApplicationRule

Tipo di regola.

sourceAddresses

string[]

Elenco di indirizzi IP di origine per questa regola.

sourceIpGroups

string[]

Elenco di ipGroup di origine per questa regola.

targetFqdns

string[]

Elenco di FQDN per questa regola.

targetUrls

string[]

Elenco di URL per questa condizione di regola.

terminateTLS

boolean

Terminare le connessioni TLS per questa regola.

webCategories

string[]

Elenco delle categorie Web di azure di destinazione.

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in caso di errore.

FirewallPolicyFilterRuleCollection

Raccolta regole filtro criteri firewall.

Nome Tipo Descrizione
action

FirewallPolicyFilterRuleCollectionAction

Tipo di azione di una raccolta di regole Filter.

name

string

Nome dell'insieme di regole.

priority

integer

Priorità della risorsa Raccolta regole dei criteri del firewall.

ruleCollectionType string:

FirewallPolicyFilterRuleCollection

Tipo dell'insieme di regole.

rules FirewallPolicyRule[]:

Elenco di regole incluse in una raccolta di regole.

FirewallPolicyFilterRuleCollectionAction

Proprietà di FirewallPolicyFilterRuleCollectionAction.

Nome Tipo Descrizione
type

FirewallPolicyFilterRuleCollectionActionType

Tipo di azione.

FirewallPolicyFilterRuleCollectionActionType

Tipo di azione di una regola.

Nome Tipo Descrizione
Allow

string

Deny

string

FirewallPolicyHttpHeaderToInsert

nome e valore dell'intestazione HTTP/S da inserire

Nome Tipo Descrizione
headerName

string

Contiene il nome dell'intestazione

headerValue

string

Contiene il valore dell'intestazione

FirewallPolicyNatRuleCollection

Raccolta regole NAT dei criteri del firewall.

Nome Tipo Descrizione
action

FirewallPolicyNatRuleCollectionAction

Tipo di azione di un insieme di regole Nat.

name

string

Nome dell'insieme di regole.

priority

integer

Priorità della risorsa Raccolta regole dei criteri del firewall.

ruleCollectionType string:

FirewallPolicyNatRuleCollection

Tipo dell'insieme di regole.

rules FirewallPolicyRule[]:

Elenco di regole incluse in una raccolta di regole.

FirewallPolicyNatRuleCollectionAction

Proprietà del firewallPolicyNatRuleCollectionAction.

Nome Tipo Descrizione
type

FirewallPolicyNatRuleCollectionActionType

Tipo di azione.

FirewallPolicyNatRuleCollectionActionType

Tipo di azione di una regola.

Nome Tipo Descrizione
DNAT

string

FirewallPolicyRuleApplicationProtocol

Proprietà del protocollo della regola dell'applicazione.

Nome Tipo Descrizione
port

integer

Numero di porta per il protocollo, non può essere maggiore di 64000.

protocolType

FirewallPolicyRuleApplicationProtocolType

Tipo di protocollo.

FirewallPolicyRuleApplicationProtocolType

Tipo di protocollo dell'applicazione di una regola.

Nome Tipo Descrizione
Http

string

Https

string

FirewallPolicyRuleCollectionGroup

Risorsa Gruppo di raccolta regole.

Nome Tipo Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id

string

ID risorsa.

name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.

properties.priority

integer

Priorità della risorsa Gruppo di raccolta regole criteri firewall.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa del gruppo di raccolta regole del firewall.

properties.ruleCollections FirewallPolicyRuleCollection[]:

Gruppo di raccolte di regole dei criteri del firewall.

properties.size

string

Stringa di sola lettura che rappresenta le dimensioni di FirewallPolicyRuleCollectionGroupProperties in MB. (ex 1,2 MB)

type

string

Tipo gruppo di regole.

FirewallPolicyRuleNetworkProtocol

Protocollo di rete di una regola.

Nome Tipo Descrizione
Any

string

ICMP

string

TCP

string

UDP

string

NatRule

Regola di tipo nat.

Nome Tipo Descrizione
description

string

Descrizione della regola.

destinationAddresses

string[]

Elenco di indirizzi IP di destinazione o tag di servizio.

destinationPorts

string[]

Elenco delle porte di destinazione.

ipProtocols

FirewallPolicyRuleNetworkProtocol[]

Matrice di FirewallPolicyRuleNetworkProtocols.

name

string

Nome della regola.

ruleType string:

NatRule

Tipo di regola.

sourceAddresses

string[]

Elenco di indirizzi IP di origine per questa regola.

sourceIpGroups

string[]

Elenco di ipGroup di origine per questa regola.

translatedAddress

string

Indirizzo tradotto per questa regola NAT.

translatedFqdn

string

FQDN tradotto per questa regola NAT.

translatedPort

string

Porta tradotta per questa regola NAT.

NetworkRule

Regola di rete di tipo.

Nome Tipo Descrizione
description

string

Descrizione della regola.

destinationAddresses

string[]

Elenco di indirizzi IP di destinazione o tag di servizio.

destinationFqdns

string[]

Elenco di FQDN di destinazione.

destinationIpGroups

string[]

Elenco di IpGroup di destinazione per questa regola.

destinationPorts

string[]

Elenco delle porte di destinazione.

ipProtocols

FirewallPolicyRuleNetworkProtocol[]

Matrice di FirewallPolicyRuleNetworkProtocols.

name

string

Nome della regola.

ruleType string:

NetworkRule

Tipo di regola.

sourceAddresses

string[]

Elenco di indirizzi IP di origine per questa regola.

sourceIpGroups

string[]

Elenco di ipGroup di origine per questa regola.

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string