tipo de recurso networkAccessTraffic

Espacio de nombres: microsoft.graph.networkaccess

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una entrada de registro de tráfico de acceso a la red. Contiene información completa sobre eventos de tráfico de red, lo que ofrece información detallada sobre la naturaleza y las características del tráfico a través de los servicios de acceso seguro global (GSA).

Métodos

Método Tipo devuelto Descripción
List colección microsoft.graph.networkaccess.networkAccessTraffic Obtenga una lista de los objetos microsoft.graph.networkaccess.networkAccessTraffic y sus propiedades.
Get microsoft.graph.networkaccess.networkAccessTraffic Lee las propiedades y relaciones de un objeto networkAccessTraffic.

Propiedades

Propiedad Tipo Descripción
acción microsoft.graph.networkaccess.filteringPolicyAction Indica la acción tomada en función de las directivas de filtrado. Los valores posibles son: block, allow, unknownFutureValue, bypass, alert. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: bypass , alert.
agentVersion Cadena Representa la versión del software de agente de cliente de Global Secure Access (GSA). Admite $filter (eq) y $orderby.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot Id. de aplicación de destino al que se accede en Azure AD durante la transacción. Admite $filter (eq) y $orderby.
cloudApplicationMetadata microsoft.graph.networkaccess.cloudApplicationMetadata Contiene metadatos sobre la aplicación en la nube involucrada en la transacción de red, como el nombre de la aplicación, la categoría y el nivel de riesgo. Admite $filter (eq) y $orderby.
connectionId Cadena Representa un identificador único asignado a una conexión. Admite $filter (eq) y $orderby.
createdDateTime DateTimeOffset Representa la fecha y hora en que se creó una entrada de registro de tráfico de acceso a la red. Admite $filter (eq) y $orderby.
description Cadena Mensaje de error informativo. Por ejemplo: "La inteligencia sobre amenazas detectó una transacción y desencadenó una alerta" o "La directiva de acceso seguro global (GSA) bloqueó el destino y desencadenó una alerta". Admite $filter (eq) y $orderby.
destinationFQDN Cadena Representa el nombre de dominio completo (FQDN) del host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby.
destinationIp Cadena Representa la dirección IP del host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby.
puerto de destino Int32 Representa el número de puerto de red en el host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby.
destinationUrl Cadena Representa la dirección URL del destino en una comunicación de red. Admite $filter (eq) y $orderby.
destinationWebCategory microsoft.graph.networkaccess.webCategory La categoría web del FQDN de destino (por ejemplo, Apuestas). Admite $filter (eq) y $orderby.
deviceCategory microsoft.graph.networkaccess.deviceCategory Representa la clasificación de categoría de un dispositivo dentro de una infraestructura de red. Los valores posibles son: client, branch, unknownFutureValue. Admite $filter (eq) y $orderby.
deviceId Cadena Representa un identificador único asignado a un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby.
deviceOperatingSystem Cadena Representa el sistema operativo instalado en un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby.
deviceOperatingSystemVersion Cadena Representa la versión o el número de versión del sistema operativo instalado en un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby.
filteringProfileId Cadena El identificador del perfil de filtrado asociado con la acción realizada en el tráfico. Admite $filter (eq) y $orderby.
filteringProfileName Cadena Nombre del perfil de filtrado asociado a la acción realizada en el tráfico. Admite $filter (eq) y $orderby.
encabezados microsoft.graph.networkaccess.headers Representa los encabezados incluidos en una solicitud o respuesta de red. Admite $filter (eq) y $orderby.
httpMethod microsoft.graph.networkaccess.httpMethod El método HTTP inspeccionado en el tráfico HTTP interceptado. Admite $filter (eq) y $orderby.
initiatingProcessName Cadena El proceso que inicia la transacción de tráfico. Admite $filter (eq) y $orderby.
protocolo de red microsoft.graph.networkaccess.networkingProtocol Representa el protocolo de red usado para la comunicación. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Admite $filter (eq) y $orderby.
operationStatus microsoft.graph.networkaccess.networkTrafficOperationStatus Indicación de si el tráfico se procesó correctamente. Los valores posibles son: success, failure, unknownFutureValue. Admite $filter (eq) y $orderby.
policyId Cadena Representa un identificador único asignado a una directiva. Admite $filter (eq) y $orderby.
policyName Cadena Nombre de la directiva de filtrado asociada a la acción realizada en el tráfico. Admite $filter (eq) y $orderby.
policyRuleId Cadena Representa un identificador único asignado a una regla de directiva. Admite $filter (eq) y $orderby.
policyRuleName Cadena Nombre de la regla asociada a la acción realizada en el tráfico. Admite $filter (eq) y $orderby.
popProcessingRegion Cadena La región de procesamiento de punto de presencia del tráfico. Admite $filter (eq) y $orderby.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Detalles sobre el tráfico de acceso privado. Admite $filter (eq) y $orderby.
receivedBytes Int64 Representa el número total de bytes recibidos en una comunicación de red o transferencia de datos. Admite $filter (eq) y $orderby.
remoteNetworkId Cadena Id. desde el que se envía o recibe el tráfico, lo que proporciona visibilidad sobre el origen del tráfico. Admite $filter (eq) y $orderby.
resourceTenantId Cadena Identificador del espacio empresarial propietario del recurso. Admite $filter (eq) y $orderby.
responseCode Int32 El código de respuesta HTTP inspeccionado en el tráfico HTTP interceptado. Admite $filter (eq) y $orderby.
sentBytes Int64 Representa el número total de bytes enviados en una comunicación de red o una transferencia de datos. Admite $filter (eq) y $orderby.
sessionId Cadena Representa un identificador único asignado a una sesión o conexión dentro de una infraestructura de red. Admite $filter (eq) y $orderby.
dirección IP de origen Cadena Representa la dirección IP de origen en una comunicación de red. Admite $filter (eq) y $orderby.
puerto de origen Int32 Representa el número de puerto de red en el dispositivo o host de origen en una comunicación de red. Admite $filter (eq) y $orderby.
tenantId Cadena Representa un identificador único asignado a un inquilino dentro de una infraestructura de red. Admite $filter (eq) y $orderby.
threatType Cadena El tipo de amenaza detectada en el tráfico. Admite $filter (eq) y $orderby.
trafficType microsoft.graph.networkaccess.trafficType Representa el tipo o la categoría de tráfico de red. Los valores posibles son: internet, private, microsoft365, all, unknownFutureValue. Admite $filter (eq) y $orderby.
transactionId String Representa un identificador único asignado a una transacción u operación específica. Clave. Admite $filter (eq) y $orderby.
transportProtocolo microsoft.graph.networkaccess.networkingProtocol Representa el protocolo de transporte utilizado para la comunicación. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Admite $filter (eq) y $orderby.
userId Cadena Representa un identificador único asignado a un usuario. Admite $filter (eq) y $orderby.
userPrincipalName Cadena Representa el nombre principal de usuario (UPN) asociado a un usuario. Admite $filter (eq) y $orderby.
vendorNames Collection(String) El nombre de los proveedores que detectaron la amenaza. Admite $filter (eq) y $orderby.

Relaciones

Relación Tipo Descripción
dispositivo dispositivo Representa el dispositivo asociado con el tráfico de red y proporciona detalles sobre el hardware o la máquina virtual implicada en la transacción.
usuario user Representa el usuario asociado con el tráfico de red, proporcionando detalles sobre la persona o cuenta que inicia la transacción.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.networkaccess.networkAccessTraffic",
  "transactionId": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "tenantId": "String",
  "connectionId": "String",
  "sessionId": "String",
  "trafficType": "String",
  "deviceCategory": "String",
  "destinationIp": "String",
  "destinationPort": "Integer",
  "destinationFQDN": "String",
  "destinationUrl": "String",
  "sourceIp": "String",
  "sourcePort": "Integer",
  "deviceOperatingSystem": "String",
  "deviceOperatingSystemVersion": "String",
  "agentVersion": "String",
  "deviceId": "String",
  "userId": "String",
  "userPrincipalName": "String",
  "transportProtocol": "String",
  "networkProtocol": "String",
  "action": "String",
  "policyRuleId": "String",
  "policyId": "String",
  "sentBytes": "Integer",
  "receivedBytes": "Integer",
  "headers": {
    "@odata.type": "microsoft.graph.networkaccess.headers"
  },
  "destinationWebCategory": {
    "@odata.type": "microsoft.graph.networkaccess.webCategory"
  },
  "filteringProfileId": "String",
  "filteringProfileName": "String",
  "policyName": "String",
  "policyRuleName": "String",
  "initiatingProcessName": "String",
  "resourceTenantId": "String",
  "threatType": "String",
  "applicationSnapshot": {
    "@odata.type": "microsoft.graph.networkaccess.applicationSnapshot"
  },
  "privateAccessDetails": {
    "@odata.type": "microsoft.graph.networkaccess.privateAccessDetails"
  },
  "description": "String",
  "vendorNames": ["String"],
  "remoteNetworkId": "String",
  "httpMethod": "String",
  "responseCode": "Integer",
  "operationStatus": "String",
  "popProcessingRegion": "String",
  "cloudApplicationMetadata": {
    "@odata.type": "microsoft.graph.networkaccess.cloudApplicationMetadata"
  }
}