Obtenir networkAccessTraffic

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 .

Récupérez les propriétés et les relations d’un objet networkAccessTraffic .

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ❌

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) NetworkAccess-Reports.Read.All NetworkAccess.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application NetworkAccess-Reports.Read.All NetworkAccess.ReadWrite.All

Requête HTTP

GET /networkAccess/logs/traffic/{transactionId}

Paramètres facultatifs de la requête

Cette méthode prend en charge le paramètre de $select requête OData pour personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

En cas de réussite, cette méthode renvoie un code de réponse et un 200 OK objet networkAccessTraffic dans le corps de la réponse.

Exemples

Demande

Voici un exemple de requête.

GET https://graph.microsoft.com/beta/networkAccess/logs/traffic/5062f456-9d9e-477b-b788-b7aa6b5d402b

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#networkAccess/logs/traffic/$entity",
  "transactionId": "5062f456-9d9e-477b-b788-b7aa6b5d402b",
  "createdDateTime": "2025-04-02T15:30:45Z",
  "tenantId": "5c3b997a-7ef9-4b2a-a63b-0271df6ace3b",
  "connectionId": "6d3c2e8f-9a1b-4c7d-8e5f-0231df6ace1a",
  "sessionId": "7f2d1b9e-8c0a-5d6e-9f4e-1342ef7bdf2c",
  "trafficType": "internet",
  "deviceCategory": "client",
  "destinationIp": "203.0.113.5",
  "destinationPort": 443,
  "destinationFQDN": "example.com",
  "destinationUrl": "https://example.com/resources/document.pdf",
  "sourceIp": "192.168.1.100",
  "sourcePort": 54321,
  "deviceOperatingSystem": "Windows 11",
  "deviceOperatingSystemVersion": "22H2",
  "agentVersion": "1.0.123.45",
  "deviceId": "4c8b9a7d-6e5f-3c2d-1b0a-9f8e7d6c5b4a",
  "userId": "2a3b4c5d-6e7f-8g9h-0i1j-2k3l4m5n6o7p",
  "userPrincipalName": "user@contoso.com",
  "transportProtocol": "tcp",
  "networkProtocol": "tcp",
  "action": "allow",
  "policyRuleId": "3d4e5f6g-7h8i-9j0k-1l2m-3n4o5p6q7r8s",
  "policyId": "9a8b7c6d-5e4f-3g2h-1i0j-9k8l7m6n5o4p",
  "sentBytes": 1024,
  "receivedBytes": 8192,
  "destinationWebCategory": {
    "displayName": "Business",
    "name": "business",
    "group": "Productivity"
  },
  "filteringProfileId": "5f6g7h8i-9j0k-1l2m-3n4o-5p6q7r8s9t0u",
  "filteringProfileName": "Standard Security Profile",
  "policyName": "Internet Traffic Policy",
  "policyRuleName": "Allow Business Websites",
  "initiatingProcessName": "browser.exe",
  "resourceTenantId": "5c3b997a-7ef9-4b2a-a63b-0271df6ace3b",
  "description": "Standard internet traffic",
  "httpMethod": "get",
  "responseCode": 200,
  "operationStatus": "success",
  "popProcessingRegion": "westus"
}

Contenu connexe

  • Dernière mise à jour :