命名空间:microsoft.graph.networkaccess
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
获取基于全局安全访问中指定时间段内聚合流量日志的 云应用程序报告 集合。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派(工作或学校帐户) | NetworkAccessPolicy.Read.All | NetworkAccessPolicy.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
重要
对于使用工作或学校帐户的委派访问,必须为登录用户分配受支持的Microsoft Entra角色或授予此操作所需权限的自定义角色。 此操作支持以下内置角色,这些角色仅提供所需的最小特权:
- 全局读取者
- 全局安全访问日志读取器
- 全局安全访问管理员
- 安全管理员
HTTP 请求
GET /networkAccess/reports/getCloudApplicationReport(startDateTime={startDateTime},endDateTime={endDateTime})
函数参数
在请求 URL 中,提供以下查询参数(含值)。
| 参数 | 类型 | 说明 |
|---|---|---|
| startDateTime | DateTimeOffset | 报告周期开始的日期和时间。 |
| endDateTime | DateTimeOffset | 报告周期结束的日期和时间。 |
| userId | String | 可选。 用于筛选云应用程序报告的用户的标识符,该用户只向此用户访问的应用报告。 |
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此函数在 200 OK 响应正文中返回响应代码和 microsoft.graph.networkaccess.cloudApplicationReport 集合。
示例
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/networkAccess/reports/getCloudApplicationReport(startDateTime={startDateTime},endDateTime={endDateTime},userId={userId})
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.networkaccess.cloudApplicationReport)",
"value":[
{
"trafficType":"internet",
"firstAccessDateTime":"2023-08-09T13:20:04Z",
"lastAccessDateTime":"2023-08-21T13:20:04Z",
"transactionCount":125,
"userCount":15,
"deviceCount":8,
"totalBytesSent":2048576,
"totalBytesReceived":4096000,
"cloudApplicationCatalogId":"12345",
"name":"ChatGPT",
"generalScore":85,
"riskScore":15,
"complianceScore":90,
"legalScore":88,
"categories": [ "Generative AI" ],
"securityScore":92
},
{
"trafficType":"internet",
"firstAccessDateTime":"2023-08-09T08:30:15Z",
"lastAccessDateTime":"2023-08-21T17:45:30Z",
"transactionCount":89,
"userCount":12,
"deviceCount":6,
"totalBytesSent":1024000,
"totalBytesReceived":2048000,
"cloudApplicationCatalogId":"67890",
"name":"Salesforce",
"generalScore":95,
"riskScore":5,
"complianceScore":98,
"legalScore":96,
"categories": [ "Collaboration", "Productivity", "Content management" ],
"securityScore":97
}
]
}