Partager via


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 Global Secure Access (GSA), 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 les status de connexion.

Méthodes

Méthode Type de retour Description
List collection microsoft.graph.networkaccess.connection Obtenez la 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
agentVersion String Version du client qui a lancé la connexion.
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot appId (ou ID client) de l’application Microsoft Entra destination.
createdDateTime DateTimeOffset Heure à laquelle la connexion a été créée.
destinationFqdn String Nom de domaine complet de destination de la connexion.
destinationIp String Adresse 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 de cette énumération évolutive : remoteNetwork.
deviceId String The DeviceID.
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é arrêtée.
id String Identificateur unique de la connexion. Hérité de microsoft.graph.entity.
initiatingProcessName String Processus initialisant la connexion de trafic.
lastUpdateDateTime DateTimeOffset Lorsque la connexion a été mise à jour pour la dernière fois.
networkProtocol microsoft.graph.networkaccess.networkingProtocol Protocole réseau de la connexion. Les valeurs possibles sont , ip, icmp, igmpggp, ipv4, puptcp, , udp, ipv6FragmentHeaderipv6RoutingHeaderipv6ipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6idpipv6NoNextHeader, ipv6DestinationOptions, . ndrawipxspxspxIIunknownFutureValue
popProcessingRegion String Région de traitement du point de présence du trafic.
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails Détails de l’accès privé.
octets reçus Int64 Octets cumulés reçus.
sentBytes Int64 Octets cumulés envoyés.
sourceIp String Adresse IP source de la connexion.
sourcePort 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 locataire où la connexion a été lancé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 de cette énumération évolutive : microsoft.
transactionBlockCount Int32 Nombre de transactions bloquées appartenant à la connexion.
transactionCount Int32 Nombre de transactions appartenant à la connexion.
transportProtocol microsoft.graph.networkaccess.networkingProtocol Protocole de transport de la connexion. Les valeurs possibles sont , ip, icmp, igmpggp, ipv4, puptcp, , udp, ipv6FragmentHeaderipv6RoutingHeaderipv6ipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6idpipv6NoNextHeader, ipv6DestinationOptions, . ndrawipxspxspxIIunknownFutureValue
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"
}