networkAccessTraffic resource type

Namespace: microsoft.graph.networkaccess

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a network access traffic log entry. It contains comprehensive information regarding network traffic events, offering detailed insights into the nature and characteristics of the traffic through the Global Secure Access services.

Methods

Method Return type Description
List microsoft.graph.networkaccess.networkAccessTraffic collection Get a list of the microsoft.graph.networkaccess.networkAccessTraffic objects and their properties.

Properties

Property Type Description
action microsoft.graph.networkaccess.filteringPolicyAction Indicates what action to take based on filtering policies. The possible values are: block, allow.
agentVersion String Represents the version of the Global Secure Access client agent software. Supports $filter (eq) and $orderby.
connectionId String Represents a unique identifier assigned to a connection. Supports $filter (eq) and $orderby.
createdDateTime DateTimeOffset Represents the date and time when a network access traffic log entry was created. Supports $filter (eq) and $orderby.
destinationFQDN String Represents the Fully Qualified Domain Name (FQDN) of the destination host or server in a network communication. Supports $filter (eq) and $orderby.
destinationIp String Represents the IP address of the destination host or server in a network communication. Supports $filter (eq) and $orderby.
destinationPort Int32 Represents the network port number on the destination host or server in a network communication. Supports $filter (eq) and $orderby.
deviceCategory microsoft.graph.networkaccess.deviceCategory Represents the category classification of a device within a network infrastructure. The possible values are: client, branch, unknownFutureValue. Supports $filter (eq) and $orderby.
deviceId String Represents a unique identifier assigned to a device within a network infrastructure. Supports $filter (eq) and $orderby.
deviceOperatingSystem String Represents the operating system installed on a device within a network infrastructure. Supports $filter (eq) and $orderby.
deviceOperatingSystemVersion String Represents the version or release number of the operating system installed on a device within a network infrastructure. Supports $filter (eq) and $orderby.
headers microsoft.graph.networkaccess.headers Represents the headers included in a network request or response. Supports $filter (eq) and $orderby.
networkProtocol microsoft.graph.networkaccess.networkingProtocol Represents the networking protocol used for communication.The possible values are: ip, icmp, igmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHeader, icmpV6, ipv6NoNextHeader, ipv6DestinationOptions, nd, raw, ipx, spx, spxII, unknownFutureValue. Supports $filter (eq) and $orderby.
policyId String Represents a unique identifier assigned to a policy. Supports $filter (eq) and $orderby.
policyRuleId String Represents a unique identifier assigned to a policy rule. Supports $filter (eq) and $orderby.
receivedBytes Int64 Represents the total number of bytes received in a network communication or data transfer. Supports $filter (eq) and $orderby.
sentBytes Int64 Represents the total number of bytes sent in a network communication or data transfer. Supports $filter (eq) and $orderby.
sessionId String Represents a unique identifier assigned to a session or connection within a network infrastructure. Supports $filter (eq) and $orderby.
sourceIp String Represents the source IP address in a network communication. Supports $filter (eq) and $orderby.
sourcePort Int32 Represents the network port number on the source host or device in a network communication. Supports $filter (eq) and $orderby.
tenantId String Represents a unique identifier assigned to a tenant within a network infrastructure. Supports $filter (eq) and $orderby.
trafficType microsoft.graph.networkaccess.trafficType Represents the type or category of network traffic.The possible values are: internet, private, microsoft365, all, unknownFutureValue. Supports $filter (eq) and $orderby.
transactionId String Represents a unique identifier assigned to a specific transaction or operation. Key. Supports $filter (eq) and $orderby.
transportProtocol microsoft.graph.networkaccess.networkingProtocol Represents the transport protocol used for communication.The possible values are: ip, icmp, igmp, ggp, ipv4, tcp, pup, udp, idp, ipv6, ipv6RoutingHeader, ipv6FragmentHeader, ipSecEncapsulatingSecurityPayload, ipSecAuthenticationHeader, icmpV6, ipv6NoNextHeader, ipv6DestinationOptions, nd, raw, ipx, spx, spxII, unknownFutureValue. Supports $filter (eq) and $orderby.
userId String Represents a unique identifier assigned to a user. Supports $filter (eq) and $orderby.
userPrincipalName String Represents the user principal name (UPN) associated with a user. Supports $filter (eq) and $orderby.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@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",
  "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"
  }
}