Leer en inglés

Compartir a través de


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=2024-05-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
networkWatcherName
path True

string

Nombre del monitor de red.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.

api-version
query True

string

Versión de la API de cliente.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
profiles True

NetworkConfigurationDiagnosticProfile[]

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

VerbosityLevel

Nivel de detalle.

Respuestas

Nombre Tipo Description
200 OK

NetworkConfigurationDiagnosticResponse

Solicitud correcta. La operación devuelve el resultado del diagnóstico de configuración de red.

202 Accepted

NetworkConfigurationDiagnosticResponse

Aceptado y la operación se completará de forma asincrónica.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de 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 la cuenta de usuario

Ejemplos

Network configuration diagnostic

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/networkConfigurationDiagnostic?api-version=2024-05-01

{
  "targetResourceId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1",
  "profiles": [
    {
      "direction": "Inbound",
      "protocol": "TCP",
      "source": "10.1.0.4",
      "destination": "12.11.12.14",
      "destinationPort": "12100"
    }
  ]
}

Respuesta de muestra

{
  "results": [
    {
      "profile": {
        "direction": "Inbound",
        "protocol": "TCP",
        "source": "10.1.0.4",
        "destination": "12.11.12.14",
        "destinationPort": "12100"
      },
      "networkSecurityGroupResult": {
        "securityRuleAccessResult": "Allow",
        "evaluatedNetworkSecurityGroups": [
          {
            "networkSecurityGroupId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nsg1",
            "appliedTo": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/subnets/AppSubnet",
            "matchedRule": {
              "ruleName": "UserRule_fe_rule",
              "action": "Allow"
            },
            "rulesEvaluationResult": [
              {
                "name": "UserRule_Cleanuptool-Allow-100",
                "protocolMatched": true,
                "sourceMatched": false,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Allow-101",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Allow-102",
                "protocolMatched": true,
                "sourceMatched": false,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Deny-103",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_fe_rule",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": true
              }
            ]
          },
          {
            "networkSecurityGroupId": "/subscriptions/61cc8a98-a8be-4bfe-a04e-0b461f93fe35/resourceGroups/NwRgCentralUSEUAP_copy/providers/Microsoft.Network/networkSecurityGroups/AppNSG",
            "appliedTo": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/networkInterfaces/nic",
            "matchedRule": {
              "ruleName": "UserRule_fe_rule",
              "action": "Allow"
            },
            "rulesEvaluationResult": [
              {
                "name": "UserRule_fe_rule",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": true
              }
            ]
          }
        ]
      }
    }
  ]
}
Location: https:/management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/networkConfigurationDiagnostic?api-version=2024-05-01
{
  "results": [
    {
      "profile": {
        "direction": "Inbound",
        "protocol": "TCP",
        "source": "10.1.0.4",
        "destination": "12.11.12.14",
        "destinationPort": "12100"
      },
      "networkSecurityGroupResult": {
        "securityRuleAccessResult": "Allow",
        "evaluatedNetworkSecurityGroups": [
          {
            "networkSecurityGroupId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nsg1",
            "appliedTo": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/subnets/AppSubnet",
            "matchedRule": {
              "ruleName": "UserRule_fe_rule",
              "action": "Allow"
            },
            "rulesEvaluationResult": [
              {
                "name": "UserRule_Cleanuptool-Allow-100",
                "protocolMatched": true,
                "sourceMatched": false,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Allow-101",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Allow-102",
                "protocolMatched": true,
                "sourceMatched": false,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_Cleanuptool-Deny-103",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": false
              },
              {
                "name": "UserRule_fe_rule",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": true
              }
            ]
          },
          {
            "networkSecurityGroupId": "/subscriptions/61cc8a98-a8be-4bfe-a04e-0b461f93fe35/resourceGroups/NwRgCentralUSEUAP_copy/providers/Microsoft.Network/networkSecurityGroups/AppNSG",
            "appliedTo": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/vnet/networkInterfaces/nic",
            "matchedRule": {
              "ruleName": "UserRule_fe_rule",
              "action": "Allow"
            },
            "rulesEvaluationResult": [
              {
                "name": "UserRule_fe_rule",
                "protocolMatched": true,
                "sourceMatched": true,
                "sourcePortMatched": true,
                "destinationMatched": true,
                "destinationPortMatched": true
              }
            ]
          }
        ]
      }
    }
  ]
}

Definiciones

Nombre Description
Direction

Dirección del tráfico.

ErrorDetails

Representación de detalles de error comunes.

ErrorResponse

Objeto de error.

EvaluatedNetworkSecurityGroup

Resultados de la evaluación del grupo de seguridad de red.

MatchedRule

Regla coincidente.

NetworkConfigurationDiagnosticParameters

Parámetros para obtener el diagnóstico de configuración de red.

NetworkConfigurationDiagnosticProfile

Parámetros que se van a comparar con la configuración de red.

NetworkConfigurationDiagnosticResponse

Resultados del diagnóstico de configuración de red en el recurso de destino.

NetworkConfigurationDiagnosticResult

El resultado del diagnóstico de configuración de red se corresponde con la consulta de tráfico proporcionada.

NetworkSecurityGroupResult

El resultado del diagnóstico de configuración de red corresponde a la consulta de tráfico proporcionada.

NetworkSecurityRulesEvaluationResult

Resultado de evaluación de reglas de seguridad de red.

SecurityRuleAccess

Indica si se permite o deniega el tráfico de red.

VerbosityLevel

Nivel de detalle.

Direction

Dirección del tráfico.

Valor Description
Inbound
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

ErrorDetails

Error
Objeto de detalles del error.

EvaluatedNetworkSecurityGroup

Resultados de la evaluación del grupo de seguridad de red.

Nombre Tipo Description
appliedTo

string

Identificador de recurso de la nic o subred a la que se aplica el grupo de seguridad de red.

matchedRule

MatchedRule

Regla de seguridad de red coincidente.

networkSecurityGroupId

string

Identificador del grupo de seguridad de red.

rulesEvaluationResult

NetworkSecurityRulesEvaluationResult[]

Lista de resultados de evaluación de reglas de seguridad de red.

MatchedRule

Regla coincidente.

Nombre Tipo Description
action

string

Se permite o deniega el tráfico de red. Los valores posibles son "Allow" y "Deny".

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

NetworkConfigurationDiagnosticProfile[]

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

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 único puerto en el intervalo (0 - 65535).

direction

Direction

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

NetworkConfigurationDiagnosticResult[]

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

NetworkSecurityGroupResult

Resultado del grupo de seguridad de red.

profile

NetworkConfigurationDiagnosticProfile

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

EvaluatedNetworkSecurityGroup[]

Lista de resultados de diagnóstico de grupos de seguridad de red.

securityRuleAccessResult

SecurityRuleAccess

Se permite o deniega el tráfico de red.

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

Indica si se permite o deniega el tráfico de red.

Valor Description
Allow
Deny

VerbosityLevel

Nivel de detalle.

Valor Description
Full
Minimum
Normal