Type de ressource de connexion

Espace de noms : microsoft.graph.networkaccess

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Dans GSA (Global Secure Access), une connexion représente plusieurs networkAccessTraffic qui se produisent et partagent un ID de connexion unique. Fournit des informations sur les connexions réseau, notamment les détails de la source et de la destination, les statistiques de trafic et le status de la connexion.

Méthodes

Méthode Type de retour Description
List collection Microsoft.Graph.NetworkAccess.Connection Obtenez une liste des objets de connexion et leurs propriétés.
Obtenir Microsoft.Graph.NetworkAccess.Connection Lire les propriétés et les relations d’un objet de connexion.

Propriétés

Propriété Type Description
version de l’agent String Version du client qui a initié la connexion.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (ou ID client) de l’application Microsoft Entra de destination.
createdDateTime DateTimeOffset Heure de création de la connexion.
crossTenantAccessType microsoft.graph.networkaccess.crossTenantAccessType Détails de l’accès inter-locataires, pour les scénarios B2B. Les valeurs possibles sont none, b2bCollaboration, unknownFutureValue.
destinationFqdn String Nom de domaine complet de destination de la connexion.
destinationIp String IP de destination de la connexion.
destinationPort Int32 Port de destination de la connexion.
deviceCategory microsoft.graph.networkaccess.deviceCategory Catégorie de l’appareil. Les valeurs possibles sont : client, branch, unknownFutureValue, remoteNetwork. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : remoteNetwork.
deviceId String The DeviceID.
deviceJoinType microsoft.graph.networkaccess.deviceJoinType Type d’inscription de l’appareil, pour les scénarios BYOD. Les valeurs possibles sont : none, microsoftEntraJoined, microsoftEntraRegistered, unknownFutureValue.
deviceOperatingSystem String Type de système d’exploitation de l’appareil.
deviceOperatingSystemVersion String Version du système d’exploitation de l’appareil.
endDateTime DateTimeOffset Heure à laquelle la connexion a été interrompue.
homeTenantId String Identificateur du locataire d’accueil, pour les scénarios B2B d’Entra.
id String Identifiant unique de la connexion. Hérité de microsoft.graph.entity.
initiatingProcessName String Processus initiant la connexion de trafic.
lastUpdateDateTime DateTimeOffset Date de la dernière mise à jour de la connexion.
networkProtocol microsoft.graph.networkaccess.networkingProtocol Protocole réseau de la connexion. Les valeurs possibles sont : ip, , igmp, ggpipxipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipv6RoutingHeaderipv6ipSecAuthenticationHeaderndipv6DestinationOptionsrawipv6NoNextHeaderspxspxIIipv4pupunknownFutureValuetcpudpidpicmpV6icmp
popProcessingRegion String La région de traitement du point de présence du trafic.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Détails de l’accès privé.
receivedBytes Int64 Octets cumulés reçus.
sentBytes Int64 Octets cumulés envoyés.
source Ip String IP source de la connexion.
port source Int32 Port source de la connexion.
status microsoft.graph.networkaccess.connectionStatus État de la connexion. Les valeurs possibles sont : open, active, closed, unknownFutureValue.
tenantId String ID du client où la connexion a été initiée.
trafficType microsoft.graph.networkaccess.trafficType Type de trafic. Les valeurs possibles sont internet, private, microsoft365, all, unknownFutureValue, microsoft. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : microsoft.
transactionBlockCount Int32 Nombre de transactions bloquées appartenant à la connexion.
transactionCount Int32 Nombre de transactions appartenant à la connexion.
protocole de transport microsoft.graph.networkaccess.networkingProtocol Protocole de transport de la connexion. Les valeurs possibles sont : ip, , igmp, ggpipxipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipv6RoutingHeaderipv6ipSecAuthenticationHeaderndipv6DestinationOptionsrawipv6NoNextHeaderspxspxIIipv4pupunknownFutureValuetcpudpidpicmpV6icmp
userId String ID de l’utilisateur.
userPrincipalName String Nom principal de l’utilisateur.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
}
  • Dernière mise à jour :