networkAccessTraffic リソースの種類

名前空間: microsoft.graph.networkaccess

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ネットワーク アクセス トラフィックのログ エントリを表します。 これには、ネットワーク トラフィック イベントに関する包括的な情報が含まれており、グローバル セキュア アクセス (GSA) サービスを通じてトラフィックの性質と特性に関する詳細な洞察を提供します。

メソッド

メソッド 戻り値の種類 説明
List microsoft.graph.networkaccess.networkAccessTrafficコレクション microsoft.graph.networkaccess.networkAccessTraffic オブジェクトとそのプロパティの一覧を取得します。
Get microsoft.graph.networkaccess.networkAccessTraffic networkAccessTraffic オブジェクトのプロパティと関係を読み取ります。

プロパティ

プロパティ 型 説明
action microsoft.graph.networkaccess.filteringPolicyAction フィルター ポリシーに基づいて実行されるアクションを示します。 使用可能な値: block、allow、unknownFutureValue、bypass、alert。 Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します: bypass , alert。
agentVersion 文字列 グローバル セキュア アクセス (GSA) クライアント エージェント ソフトウェアのバージョンを表します。 $filter (eq) と $orderby をサポートします。
applicationSnapshot microsoft.graph.networkaccess.applicationSnapshot トランザクション中に Azure AD でアクセスされた宛先アプリケーション ID。 $filter (eq) と $orderby をサポートします。
cloudApplicationMetadata microsoft.graph.networkaccess.cloudApplicationMetadata アプリケーション名、カテゴリ、リスク レベルなど、ネットワーク トランザクションに関与するクラウド アプリケーションに関するメタデータが含まれます。 $filter (eq) と $orderby をサポートします。
connectionId 文字列 接続に割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
createdDateTime DateTimeOffset ネットワーク アクセス トラフィックのログ エントリが作成された日時を表します。 $filter (eq) と $orderby をサポートします。
説明 String 情報エラー メッセージ。 例: "脅威インテリジェンスがトランザクションを検出し、アラートをトリガーしました。" または "グローバル セキュア アクセス (GSA) ポリシーが宛先をブロックし、アラートをトリガーしました。"$filter (eq) と $orderby をサポートします。
destinationFQDN 文字列 ネットワーク通信における宛先ホストまたはサーバーの完全修飾ドメイン名 (FQDN) を表します。 $filter (eq) と $orderby をサポートします。
destinationIp 文字列 ネットワーク通信における宛先ホストまたはサーバーの IP アドレスを表します。 $filter (eq) と $orderby をサポートします。
destinationPort Int32 ネットワーク通信における宛先ホストまたはサーバーのネットワーク ポート番号を表します。 $filter (eq) と $orderby をサポートします。
destinationUrl 文字列 ネットワーク通信における宛先の URL を表します。 $filter (eq) と $orderby をサポートします。
destinationWebCategory microsoft.graph.networkaccess.webCategory 宛先 FQDN の Web カテゴリ (ギャンブルなど)。 $filter (eq) と $orderby をサポートします。
deviceCategory microsoft.graph.networkaccess.deviceCategory ネットワーク インフラストラクチャ内でのデバイスのカテゴリ分類を表します。 使用可能な値: client、branch、unknownFutureValue。 $filter (eq) と $orderby をサポートします。
deviceId 文字列 ネットワーク インフラストラクチャ内のデバイスに割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
deviceOperatingSystem 文字列 ネットワーク インフラストラクチャ内のデバイスにインストールされているオペレーティング システムを表します。 $filter (eq) と $orderby をサポートします。
deviceOperatingSystemVersion 文字列 ネットワーク インフラストラクチャ内のデバイスにインストールされているオペレーティング システムのバージョンまたはリリース番号を表します。 $filter (eq) と $orderby をサポートします。
filteringProfileId 文字列 トラフィックに対して実行されたアクションに関連付けられたフィルタリング プロファイルの ID。 $filter (eq) と $orderby をサポートします。
filteringProfileName 文字列 トラフィックに対して実行されたアクションに関連付けられたフィルタリング プロファイルの名前。 $filter (eq) と $orderby をサポートします。
ヘッダー Microsoft.Graph.NetworkAccess.Headers ネットワーク要求または応答に含まれるヘッダーを表します。 $filter (eq) と $orderby をサポートします。
httpMethod microsoft.graph.networkaccess.httpMethod インターセプトされた HTTP トラフィックで検査された HTTP メソッド。 $filter (eq) と $orderby をサポートします。
initiatingProcessName 文字列 トラフィック トランザクションを開始するプロセス。 $filter (eq) と $orderby をサポートします。
networkProtocol microsoft.graph.networkaccess.networkingProtocol 通信に使用されるネットワーク プロトコルを表します。 可能な値は、 ip、 icmp、 igmp、 ggp、 ipv4、 tcp、 pup、 udp、 idp、 ipv6、 ipv6RoutingHeader、 ipv6FragmentHeader、 ipSecEncapsulatingSecurityPayload、 ipSecAuthenticationHeader、 icmpV6、 ipv6NoNextHeader、 ipv6DestinationOptions、 nd、 raw、 ipx、 spx、 spxII、 unknownFutureValue です。 $filter (eq) と $orderby をサポートします。
operationStatus microsoft.graph.networkaccess.networkTrafficOperationStatus トラフィックが正常に処理されたかどうかを示します。 使用可能な値: success、failure、unknownFutureValue。 $filter (eq) と $orderby をサポートします。
policyId 文字列 ポリシーに割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
policyName 文字列 トラフィックに対して実行されたアクションに関連付けられているフィルタリング ポリシーの名前。 $filter (eq) と $orderby をサポートします。
policyRuleId 文字列 ポリシー ルールに割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
policyRuleName 文字列 トラフィックに対して実行されたアクションに関連付けられているルールの名前。 $filter (eq) と $orderby をサポートします。
popProcessingRegion 文字列 トラフィックの ポイント オブ プレゼンス処理リージョン。 $filter (eq) と $orderby をサポートします。
privateAccessDetails microsoft.graph.networkaccess.privateAccessDetails プライベート アクセス トラフィックの詳細。 $filter (eq) と $orderby をサポートします。
receivedBytes Int64 ネットワーク通信またはデータ転送で受信した合計バイト数を表します。 $filter (eq) と $orderby をサポートします。
remoteNetworkId 文字列 トラフィックが送受信された ID。トラフィックの発信元を可視化します。 $filter (eq) と $orderby をサポートします。
resourceTenantId 文字列 リソースを所有するテナント ID。 $filter (eq) と $orderby をサポートします。
responseCode Int32 傍受された HTTP トラフィックで検査された HTTP 応答コード。 $filter (eq) と $orderby をサポートします。
sentBytes Int64 ネットワーク通信またはデータ転送で送信された合計バイト数を表します。 $filter (eq) と $orderby をサポートします。
sessionId 文字列 ネットワーク インフラストラクチャ内のセッションまたは接続に割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
sourceIp 文字列 ネットワーク通信の発信元 IP アドレスを表します。 $filter (eq) と $orderby をサポートします。
sourcePort Int32 ネットワーク通信の送信元ホストまたはデバイスのネットワーク ポート番号を表します。 $filter (eq) と $orderby をサポートします。
tenantId String ネットワーク インフラストラクチャ内のテナントに割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
threatType 文字列 トラフィックで検出された脅威の種類。 $filter (eq) と $orderby をサポートします。
trafficType microsoft.graph.networkaccess.trafficType ネットワーク トラフィックの種類またはカテゴリを表します。 使用可能な値: internet、private、microsoft365、all、unknownFutureValue。 $filter (eq) と $orderby をサポートします。
transactionId String 特定のトランザクションまたは操作に割り当てられた一意の識別子を表します。 キー。 $filter (eq) と $orderby をサポートします。
transportProtocol microsoft.graph.networkaccess.networkingProtocol 通信に使用されるトランスポート プロトコルを表します。 可能な値は、 ip、 icmp、 igmp、 ggp、 ipv4、 tcp、 pup、 udp、 idp、 ipv6、 ipv6RoutingHeader、 ipv6FragmentHeader、 ipSecEncapsulatingSecurityPayload、 ipSecAuthenticationHeader、 icmpV6、 ipv6NoNextHeader、 ipv6DestinationOptions、 nd、 raw、 ipx、 spx、 spxII、 unknownFutureValue です。 $filter (eq) と $orderby をサポートします。
userId String ユーザーに割り当てられた一意の識別子を表します。 $filter (eq) と $orderby をサポートします。
userPrincipalName String ユーザーに関連付けられているユーザー プリンシパル名 (UPN) を表します。 $filter (eq) と $orderby をサポートします。
vendorNames Collection(String) 脅威を検出したベンダーの名前。 $filter (eq) と $orderby をサポートします。

リレーションシップ

リレーションシップ 型 説明
デバイス device ネットワーク トラフィックに関連付けられているデバイスを表し、トランザクションに関係するハードウェアまたは仮想マシンに関する詳細を提供します。
ユーザー user ネットワーク トラフィックに関連付けられているユーザーを表し、トランザクションを開始する個人またはアカウントに関する詳細を提供します。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.networkaccess.networkAccessTraffic",
  "transactionId": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "tenantId": "String",
  "connectionId": "String",
  "sessionId": "String",
  "trafficType": "String",
  "deviceCategory": "String",
  "destinationIp": "String",
  "destinationPort": "Integer",
  "destinationFQDN": "String",
  "destinationUrl": "String",
  "sourceIp": "String",
  "sourcePort": "Integer",
  "deviceOperatingSystem": "String",
  "deviceOperatingSystemVersion": "String",
  "agentVersion": "String",
  "deviceId": "String",
  "userId": "String",
  "userPrincipalName": "String",
  "transportProtocol": "String",
  "networkProtocol": "String",
  "action": "String",
  "policyRuleId": "String",
  "policyId": "String",
  "sentBytes": "Integer",
  "receivedBytes": "Integer",
  "headers": {
    "@odata.type": "microsoft.graph.networkaccess.headers"
  },
  "destinationWebCategory": {
    "@odata.type": "microsoft.graph.networkaccess.webCategory"
  },
  "filteringProfileId": "String",
  "filteringProfileName": "String",
  "policyName": "String",
  "policyRuleName": "String",
  "initiatingProcessName": "String",
  "resourceTenantId": "String",
  "threatType": "String",
  "applicationSnapshot": {
    "@odata.type": "microsoft.graph.networkaccess.applicationSnapshot"
  },
  "privateAccessDetails": {
    "@odata.type": "microsoft.graph.networkaccess.privateAccessDetails"
  },
  "description": "String",
  "vendorNames": ["String"],
  "remoteNetworkId": "String",
  "httpMethod": "String",
  "responseCode": "Integer",
  "operationStatus": "String",
  "popProcessingRegion": "String",
  "cloudApplicationMetadata": {
    "@odata.type": "microsoft.graph.networkaccess.cloudApplicationMetadata"
  }
}

関連コンテンツ

  • 最終更新: