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.
In Global Secure Access (GSA) a connection represents multiple networkAccessTraffic occurring and sharing single connection ID. Provides information about network connections including source and destination details, traffic statistics, and connection status.
Methods
| Method | Return type | Description |
|---|---|---|
| List | microsoft.graph.networkaccess.connection collection | Get a list of the connection objects and their properties. |
| Get | microsoft.graph.networkaccess.connection | Read the properties and relationships of a connection object. |
Properties
| Property | Type | Description |
|---|---|---|
| agentVersion | String | The version of the client that initiated the connection. |
| applicationSnapshot | microsoft.graph.networkaccess.applicationSnapshot | appId (or client ID) of the destination Microsoft Entra application. |
| createdDateTime | DateTimeOffset | The time the connection was created. |
| destinationFqdn | String | The destination FQDN of the connection. |
| destinationIp | String | The destination IP of the connection. |
| destinationPort | Int32 | The destination port of the connection. |
| deviceCategory | microsoft.graph.networkaccess.deviceCategory | The category of the device. The possible values are: client, branch, unknownFutureValue, remoteNetwork. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: remoteNetwork. |
| deviceId | String | The DeviceID. |
| deviceOperatingSystem | String | The device operating system type. |
| deviceOperatingSystemVersion | String | The device operating system version. |
| endDateTime | DateTimeOffset | The time the connection was terminated. |
| id | String | The unique identifier for the connection. Inherited from microsoft.graph.entity. |
| initiatingProcessName | String | The process initiating the traffic connection. |
| lastUpdateDateTime | DateTimeOffset | When the connection was last updated. |
| networkProtocol | microsoft.graph.networkaccess.networkingProtocol | The network protocol of the connection. 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. |
| popProcessingRegion | String | The Point-of-Presence processing region of the traffic. |
| privateAccessDetails | microsoft.graph.networkaccess.privateAccessDetails | Private access details. |
| receivedBytes | Int64 | Accumulative bytes received. |
| sentBytes | Int64 | Accumulative bytes sent. |
| sourceIp | String | The source IP of the connection. |
| sourcePort | Int32 | The source port of the connection. |
| status | microsoft.graph.networkaccess.connectionStatus | Status of the connection. The possible values are: open, active, closed, unknownFutureValue. |
| tenantId | String | The ID of the tenant where the connection was initiated. |
| trafficType | microsoft.graph.networkaccess.trafficType | The type of traffic. The possible values are: internet, private, microsoft365, all, unknownFutureValue, microsoft. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: microsoft. |
| transactionBlockCount | Int32 | The number of blocked transactions belonging to the connection. |
| transactionCount | Int32 | The number of transactions belonging to the connection. |
| transportProtocol | microsoft.graph.networkaccess.networkingProtocol | The transport protocol of the connection. 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. |
| userId | String | The user ID. |
| userPrincipalName | String | The principal name of the user. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"@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"
}