命名空间：microsoft.graph.networkaccess
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
在全局安全访问 (GSA) 连接表示发生多个 networkAccessTraffic 并共享单个连接 ID。 提供有关网络连接的信息，包括源和目标详细信息、流量统计信息以及连接状态。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | microsoft.graph.networkaccess.connection collection | 获取连接对象及其属性的列表。 |
| Get | microsoft.graph.networkaccess.connection | 读取连接对象的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| agentVersion | String | 启动连接的客户端版本。 |
| applicationSnapshot | microsoft.graph.networkaccess.applicationSnapshot | appId (或客户端 ID) 目标Microsoft Entra应用程序。 |
| createdDateTime | DateTimeOffset | 创建连接的时间。 |
| destinationFqdn | String | 连接的目标 FQDN。 |
| destinationIp | String | 连接的目标 IP。 |
| destinationPort | Int32 | 连接的目标端口。 |
| deviceCategory | microsoft.graph.networkaccess.deviceCategory | 设备的类别。 可能的值包括 client、branch、unknownFutureValue、remoteNetwork。 使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： remoteNetwork。 |
| deviceId | String | DeviceID。 |
| deviceOperatingSystem | String | 设备作系统类型。 |
| deviceOperatingSystemVersion | String | 设备作系统版本。 |
| endDateTime | DateTimeOffset | 终止连接的时间。 |
| id | String | 连接的唯一标识符。 继承自 microsoft.graph.entity。 |
| initiatingProcessName | String | 启动流量连接的进程。 |
| lastUpdateDateTime | DateTimeOffset | 上次更新连接的时间。 |
| networkProtocol | microsoft.graph.networkaccess.networkingProtocol | 连接的网络协议。 可能的值为：ip、、icmp、igmptcpidpipv6pupipv4udpggp、ipSecEncapsulatingSecurityPayloadicmpV6ipv6NoNextHeaderipv6DestinationOptionsipv6RoutingHeaderipv6FragmentHeaderipSecAuthenticationHeader、nd、、raw、spxipx、 。 unknownFutureValuespxII |
| popProcessingRegion | String | 流量的接入点处理区域。 |
| privateAccessDetails | microsoft.graph.networkaccess.privateAccessDetails | 专用访问详细信息。 |
| receivedBytes | Int64 | 收到的累积字节数。 |
| sentBytes | Int64 | 已发送的累积字节数。 |
| sourceIp | String | 连接的源 IP。 |
| sourcePort | Int32 | 连接的源端口。 |
| status | microsoft.graph.networkaccess.connectionStatus | 连接状态。 可能的值包括 open、active、closed、unknownFutureValue。 |
| tenantId | String | 启动连接的租户的 ID。 |
| trafficType | microsoft.graph.networkaccess.trafficType | 流量的类型。 可能的值包括 internet、private、microsoft365、all、unknownFutureValue、microsoft。 使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： microsoft。 |
| transactionBlockCount | Int32 | 属于连接的已阻止事务数。 |
| transactionCount | Int32 | 属于连接的事务数。 |
| transportProtocol | microsoft.graph.networkaccess.networkingProtocol | 连接的传输协议。 可能的值为：ip、、icmp、igmptcpidpipv6pupipv4udpggp、ipSecEncapsulatingSecurityPayloadicmpV6ipv6NoNextHeaderipv6DestinationOptionsipv6RoutingHeaderipv6FragmentHeaderipSecAuthenticationHeader、nd、、raw、spxipx、 。 unknownFutureValuespxII |
| userId | String | 用户 ID。 |
| userPrincipalName | String | 用户的主体名称。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@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"
}