通过

sensitivityLabel： computeInheritance

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

计算输出项目应继承的敏感度标签，给定一组来自输入或引用项目的敏感度标签。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） SensitivityLabel.Evaluate.All SensitivityLabel.Evaluate
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 SensitivityLabel.Evaluate.All SensitivityLabel.Evaluate

HTTP 请求

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

筛选器参数

参数 类型 说明
applicableTo String 可选。 以逗号分隔的内容格式字符串 (例如 File,Email ，) 。 将返回的标签筛选为 仅适用于至少一种 指定格式的标签。 可能的值为 Email、、、SiteSchematizedData、TeamworkUnifiedGroup。File
区域设置 String 可选。 指定可本地化字段的区域设置。
labelIds 字符串集合 可选。 敏感度标签 GUID 的逗号分隔字符串的集合。 将返回的标签筛选为仅与指定 ID 匹配的标签。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
Client-Request-Id 可选。 用于跟踪请求的客户端生成的 GUID。 建议用于故障排除。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在响应正文中返回响应 200 OK 代码和单个 sensitivityLabel 对象，表示计算的继承标签。

如果没有根据输入和筛选器找到适用的标签，或者如果错误 (例如，) 提供的标签 ID 无效，则 API 可能会返回错误响应 (， 400 Bad Request 或者 404 Not Found) 错误 对象中的详细信息。

示例

请求

以下示例演示了从输入标签计算继承标签的请求，该请求仅考虑适用于内容格式的 File 标签。

GET https://graph.microsoft.com/beta/security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance(labelIds=["4e4234dd-377b-42a3-935b-0e42f138fa23"],locale='en-US',contentFormats=["File"])
Authorization: Bearer {token}
Content-Type: application/json
Client-Request-Id: c5e4d3b2-a1f0-e9d8-c7b6-a5e4d3b2a1f0

"4e4234dd-377b-42a3-935b-0e42f138fa23"  // General (Sensitivity 10, File/Email)

响应

以下示例显示了相应的响应。 返回 机密 标签，因为它是支持 File 内容格式的输入中最敏感的标签。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.security.sensitivityLabel",
  "id": "a7a21bba-8197-491f-a5d6-0d0f955397cf",
  "name": "Confidential",
  "description": "Confidential data.",
  "color": "#ff0000",
  "priority": 0,
  "toolTip": "Data that requires protection.",
  "isEnabled": true,
  "isEndpointProtectionEnabled": true,
  "autoTooltip": "",
  "actionSource": "manual",
  "applicableTo": "email,teamwork,file",
  "sublabels": []
}
  • Last updated on