名前空間: microsoft.graph.networkaccess
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
networkAccessTraffic オブジェクトのプロパティとリレーションシップを取得します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | NetworkAccess-Reports.Read.All | NetworkAccess.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | NetworkAccess-Reports.Read.All | NetworkAccess.ReadWrite.All |
HTTP 要求
GET /networkAccess/logs/traffic/{transactionId}
オプションのクエリ パラメーター
このメソッドは、応答のカスタマイズに役立つ $select OData クエリ パラメーターをサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答コード 200 OK と、応答本文に networkAccessTraffic オブジェクトを返します。
例
要求
要求の例を次に示します。
GET https://graph.microsoft.com/beta/networkAccess/logs/traffic/5062f456-9d9e-477b-b788-b7aa6b5d402b
応答
応答の例を次に示します。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
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"
}