tipo de recurso de conexión

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.

En el acceso seguro global (GSA), una conexión representa el tráfico de varios networkAccessTraffic que se producen y comparten un solo identificador de conexión. Proporciona información sobre las conexiones de red, incluidos los detalles del origen y el destino, las estadísticas de tráfico y el estado de la conexión.

Métodos

Método Tipo devuelto Descripción
List Colección Microsoft.Graph.NetworkAccess.Connection Obtenga una lista de los objetos de conexión y sus propiedades.
Get microsoft.graph.networkaccess.connection Lea las propiedades y relaciones de un objeto de conexión.

Propiedades

Propiedad Tipo Descripción
agentVersion Cadena La versión del cliente que inició la conexión.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (o id. de cliente) de la aplicación de Microsoft Entra de destino.
createdDateTime DateTimeOffset La hora en que se creó la conexión.
crossTenantAccessType microsoft.graph.networkaccess.crossTenantAccessType Detalles de acceso entre inquilinos, para escenarios B2B. Los valores posibles son: none, b2bCollaboration, unknownFutureValue.
destinationFqdn Cadena El FQDN de destino de la conexión.
destinationIp Cadena IP de destino de la conexión.
puerto de destino Int32 El puerto de destino de la conexión.
deviceCategory microsoft.graph.networkaccess.deviceCategory Categoría del dispositivo. Los valores posibles son: client, branch, unknownFutureValue y remoteNetwork Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: remoteNetwork.
deviceId Cadena El DeviceID.
deviceJoinType microsoft.graph.networkaccess.deviceJoinType Tipo de registro de dispositivo, para escenarios BYOD. Los valores posibles son: none, microsoftEntraJoined, microsoftEntraRegistered y unknownFutureValue
deviceOperatingSystem Cadena El tipo de sistema operativo del dispositivo.
deviceOperatingSystemVersion Cadena La versión del sistema operativo del dispositivo.
endDateTime DateTimeOffset La hora en que finalizó la conexión.
homeTenantId Cadena El identificador del inquilino principal, para escenarios de Entra B2B.
id Cadena El identificador único de la conexión. Heredado de microsoft.graph.entity.
initiatingProcessName Cadena El proceso que inicia la conexión de tráfico.
lastUpdateDateTime DateTimeOffset Cuándo se actualizó la conexión por última vez.
protocolo de red microsoft.graph.networkaccess.networkingProtocol El protocolo de red de la conexión. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
popProcessingRegion Cadena La región de procesamiento de punto de presencia del tráfico.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Detalles de acceso privado.
receivedBytes Int64 Bytes acumulativos recibidos.
sentBytes Int64 Bytes acumulativos enviados.
dirección IP de origen Cadena La IP de origen de la conexión.
puerto de origen Int32 El puerto de origen de la conexión.
status microsoft.graph.networkaccess.connectionStatus Estado de la conexión. Los valores posibles son: open, active, closed y unknownFutureValue
tenantId Cadena El identificador del inquilino donde se inició la conexión.
trafficType microsoft.graph.networkaccess.trafficType El tipo de tráfico. Los valores posibles son: internet, private, microsoft365, all, unknownFutureValue, microsoft. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: microsoft.
transactionBlockCount Int32 El número de transacciones bloqueadas que pertenecen a la conexión.
transactionCount Int32 El número de transacciones que pertenecen a la conexión.
transportProtocolo microsoft.graph.networkaccess.networkingProtocol El protocolo de transporte de la conexión. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue
userId Cadena Identificador de usuario.
userPrincipalName Cadena El nombre principal del usuario.

Relaciones

Ninguna.

Representación JSON

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

{
  "@odata.type": "#microsoft.graph.networkaccess.connection",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "tenantId": "String",
  "lastUpdateDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "trafficType": "String",
  "transactionCount": "Integer",
  "transactionBlockCount": "Integer",
  "sentBytes": "Integer",
  "receivedBytes": "Integer",
  "destinationIp": "String",
  "destinationPort": "Integer",
  "destinationFqdn": "String",
  "userId": "String",
  "sourceIp": "String",
  "sourcePort": "Integer",
  "initiatingProcessName": "String",
  "deviceId": "String",
  "deviceOperatingSystem": "String",
  "deviceOperatingSystemVersion": "String",
  "agentVersion": "String",
  "applicationSnapshot": {
    "@odata.type": "microsoft.graph.networkaccess.applicationSnapshot"
  },
  "privateAccessDetails": {
    "@odata.type": "microsoft.graph.networkaccess.privateAccessDetails"
  },
  "deviceCategory": "String",
  "userPrincipalName": "String",
  "transportProtocol": "String",
  "networkProtocol": "String",
  "popProcessingRegion": "String",
  "homeTenantId": "String",
  "crossTenantAccessType": "String",
  "deviceJoinType": "String"
}
  • Se actualizó por última vez el