Network Watchers - Get Network Configuration Diagnostic
Obtiene los datos de diagnóstico de configuración de red para ayudar a los clientes a comprender y depurar el comportamiento de la red. Proporciona información detallada sobre qué reglas de seguridad se aplicaron a un flujo de tráfico especificado y el resultado de evaluar estas reglas. Los clientes deben proporcionar detalles de un flujo como origen, destino, protocolo, etc. La API devuelve si se permitió o denegó el tráfico, las reglas evaluadas para el flujo especificado y los resultados de la evaluación.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/networkConfigurationDiagnostic?api-version=2026-01-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
network
|
path | True |
string |
Nombre del monitor de red. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Cuerpo de la solicitud
| Nombre | Requerido | Tipo | Description |
|---|---|---|---|
| profiles | True |
Lista de perfiles de diagnóstico de configuración de red. |
|
| targetResourceId | True |
string |
Identificador del recurso de destino para realizar el diagnóstico de configuración de red. Las opciones válidas son VM, NetworkInterface, VMSS/NetworkInterface y Application Gateway. |
| verbosityLevel |
Nivel de detalle. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La operación de Azure se completó correctamente. |
|
| 202 Accepted |
La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Encabezados
|
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar su cuenta de usuario |
Ejemplos
Network configuration diagnostic
Solicitud de ejemplo
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/networkConfigurationDiagnostic?api-version=2026-01-01
{
"profiles": [
{
"destination": "12.11.12.14",
"destinationPort": "12100",
"direction": "Inbound",
"source": "10.1.0.4",
"protocol": "TCP"
}
],
"targetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1"
}
Respuesta de muestra
{
"results": [
{
"networkSecurityGroupResult": {
"evaluatedNetworkSecurityGroups": [
{
"appliedTo": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/subnets/AppSubnet",
"matchedRule": {
"action": "Allow",
"ruleName": "UserRule_fe_rule"
},
"networkSecurityGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nsg1",
"rulesEvaluationResult": [
{
"name": "UserRule_Cleanuptool-Allow-100",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": false,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Allow-101",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Allow-102",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": false,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Deny-103",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
},
{
"name": "UserRule_fe_rule",
"destinationMatched": true,
"destinationPortMatched": true,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
}
]
},
{
"appliedTo": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/networkInterfaces/nic",
"matchedRule": {
"action": "Allow",
"ruleName": "UserRule_fe_rule"
},
"networkSecurityGroupId": "/subscriptions/61cc8a98-a8be-4bfe-a04e-0b461f93fe35/resourceGroups/NwRgCentralUSEUAP_copy/providers/Microsoft.Network/networkSecurityGroups/AppNSG",
"rulesEvaluationResult": [
{
"name": "UserRule_fe_rule",
"destinationMatched": true,
"destinationPortMatched": true,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
}
]
}
],
"securityRuleAccessResult": "Allow"
},
"profile": {
"destination": "12.11.12.14",
"destinationPort": "12100",
"direction": "Inbound",
"source": "10.1.0.4",
"protocol": "TCP"
}
}
]
}
Location: https:/management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/networkConfigurationDiagnostic?api-version=2025-07-01
{
"results": [
{
"networkSecurityGroupResult": {
"evaluatedNetworkSecurityGroups": [
{
"appliedTo": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/subnets/AppSubnet",
"matchedRule": {
"action": "Allow",
"ruleName": "UserRule_fe_rule"
},
"networkSecurityGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nsg1",
"rulesEvaluationResult": [
{
"name": "UserRule_Cleanuptool-Allow-100",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": false,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Allow-101",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Allow-102",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": false,
"sourcePortMatched": true
},
{
"name": "UserRule_Cleanuptool-Deny-103",
"destinationMatched": true,
"destinationPortMatched": false,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
},
{
"name": "UserRule_fe_rule",
"destinationMatched": true,
"destinationPortMatched": true,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
}
]
},
{
"appliedTo": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/networkInterfaces/nic",
"matchedRule": {
"action": "Allow",
"ruleName": "UserRule_fe_rule"
},
"networkSecurityGroupId": "/subscriptions/61cc8a98-a8be-4bfe-a04e-0b461f93fe35/resourceGroups/NwRgCentralUSEUAP_copy/providers/Microsoft.Network/networkSecurityGroups/AppNSG",
"rulesEvaluationResult": [
{
"name": "UserRule_fe_rule",
"destinationMatched": true,
"destinationPortMatched": true,
"protocolMatched": true,
"sourceMatched": true,
"sourcePortMatched": true
}
]
}
],
"securityRuleAccessResult": "Allow"
},
"profile": {
"destination": "12.11.12.14",
"destinationPort": "12100",
"direction": "Inbound",
"source": "10.1.0.4",
"protocol": "TCP"
}
}
]
}
Definiciones
| Nombre | Description |
|---|---|
| Direction |
La dirección del tráfico. |
|
Error |
Representación de detalles de error comunes. |
|
Error |
Objeto de error. |
|
Evaluated |
Resultados de la evaluación del grupo de seguridad de red. |
|
Matched |
Regla coincidente. |
|
Network |
Parámetros para obtener el diagnóstico de configuración de red. |
|
Network |
Parámetros que se van a comparar con la configuración de red. |
|
Network |
Resultados del diagnóstico de configuración de red en el recurso de destino. |
|
Network |
El resultado del diagnóstico de configuración de red se corresponde con la consulta de tráfico proporcionada. |
|
Network |
El resultado del diagnóstico de configuración de red corresponde a la consulta de tráfico proporcionada. |
|
Network |
Resultado de evaluación de reglas de seguridad de red. |
|
Security |
Si el tráfico de red está permitido o denegado. |
|
Verbosity |
Nivel de detalle. |
Direction
La dirección del tráfico.
| Valor | Description |
|---|---|
| Inbound |
Inbound |
| Outbound |
Outbound |
ErrorDetails
Representación de detalles de error comunes.
| Nombre | Tipo | Description |
|---|---|---|
| code |
string |
Código de error. |
| message |
string |
Mensaje de error. |
| target |
string |
Destino de error. |
ErrorResponse
Objeto de error.
| Nombre | Tipo | Description |
|---|---|---|
| error |
Error |
EvaluatedNetworkSecurityGroup
Resultados de la evaluación del grupo de seguridad de red.
| Nombre | Tipo | Description |
|---|---|---|
| appliedTo |
string |
Identificador de recurso de nic o subred a la que se aplica el grupo de seguridad de red. |
| matchedRule |
Regla de seguridad de red coincidente. |
|
| networkSecurityGroupId |
string |
Id. del grupo de seguridad de red. |
| rulesEvaluationResult |
Lista de resultados de evaluación de reglas de seguridad de red. |
MatchedRule
Regla coincidente.
| Nombre | Tipo | Description |
|---|---|---|
| action |
string |
El tráfico de red está permitido o denegado. Los valores posibles son 'Permitir' y 'Denegar'. |
| ruleName |
string |
Nombre de la regla de seguridad de red coincidente. |
NetworkConfigurationDiagnosticParameters
Parámetros para obtener el diagnóstico de configuración de red.
| Nombre | Tipo | Description |
|---|---|---|
| profiles |
Lista de perfiles de diagnóstico de configuración de red. |
|
| targetResourceId |
string |
Identificador del recurso de destino para realizar el diagnóstico de configuración de red. Las opciones válidas son VM, NetworkInterface, VMSS/NetworkInterface y Application Gateway. |
| verbosityLevel |
Nivel de detalle. |
NetworkConfigurationDiagnosticProfile
Parámetros que se van a comparar con la configuración de red.
| Nombre | Tipo | Description |
|---|---|---|
| destination |
string |
Destino del tráfico. Los valores aceptados son: '*', dirección IP/CIDR, etiqueta de servicio. |
| destinationPort |
string |
Puerto de destino del tráfico. Los valores aceptados son '*' y un solo puerto en el rango (0 - 65535). |
| direction |
La dirección del tráfico. |
|
| protocol |
string |
Protocolo en el que se va a comprobar. Los valores aceptados son '*', TCP, UDP. |
| source |
string |
Origen del tráfico. Los valores aceptados son '*', dirección IP/CIDR, etiqueta de servicio. |
NetworkConfigurationDiagnosticResponse
Resultados del diagnóstico de configuración de red en el recurso de destino.
| Nombre | Tipo | Description |
|---|---|---|
| results |
Lista de resultados de diagnóstico de configuración de red. |
NetworkConfigurationDiagnosticResult
El resultado del diagnóstico de configuración de red se corresponde con la consulta de tráfico proporcionada.
| Nombre | Tipo | Description |
|---|---|---|
| networkSecurityGroupResult |
Resultado del grupo de seguridad de red. |
|
| profile |
Perfil de diagnóstico de configuración de red. |
NetworkSecurityGroupResult
El resultado del diagnóstico de configuración de red corresponde a la consulta de tráfico proporcionada.
| Nombre | Tipo | Description |
|---|---|---|
| evaluatedNetworkSecurityGroups |
Lista de resultados de diagnóstico de grupos de seguridad de red. |
|
| securityRuleAccessResult |
El tráfico de red está permitido o denegado. |
NetworkSecurityRulesEvaluationResult
Resultado de evaluación de reglas de seguridad de red.
| Nombre | Tipo | Description |
|---|---|---|
| destinationMatched |
boolean |
Valor que indica si el destino coincide. |
| destinationPortMatched |
boolean |
Valor que indica si el puerto de destino coincide. |
| name |
string |
Nombre de la regla de seguridad de red. |
| protocolMatched |
boolean |
Valor que indica si el protocolo coincide. |
| sourceMatched |
boolean |
Valor que indica si el origen coincide. |
| sourcePortMatched |
boolean |
Valor que indica si el puerto de origen coincide. |
SecurityRuleAccess
Si el tráfico de red está permitido o denegado.
| Valor | Description |
|---|---|
| Allow |
Permitir |
| Deny |
Deny |
VerbosityLevel
Nivel de detalle.
| Valor | Description |
|---|---|
| Normal |
Normal |
| Minimum |
Mínimo |
| Full |
Full |