driveItem：extractSensitivityLabels

  • 项目

命名空间：microsoft.graph

提取分配给驱动器项的一个或多个敏感度标签，并使用所分配标签的最新详细信息更新驱动器项的元数据。 如果提取文件的敏感度标签失败，则会引发提取错误，并显示适用的错误代码和消息。

有关管理员角度的敏感度标签的详细信息，请参阅 在 SharePoint 和 OneDrive 中为 Office 文件启用敏感度标签。

注意：此 API 仅适用于支持的文件扩展名。 调用时，此 API 首先从数据库中检索文件的敏感度标签元数据，然后检查以确定敏感度标签详细信息是否是文件内容的最新详细信息。 如果是，则返回数据库中检索到的值。 如果不是，则从文件的内容流中提取敏感度标签，在数据库中更新相应的元数据，并返回新提取的值。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

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

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

HTTP 请求

POST /drives/{drive-id}/items/{item-id}/extractSensitivityLabels
POST /drives/{drive-id}/root:/{item-path}:/extractSensitivityLabels
POST /groups/{group-id}/drive/items/{item-id}/extractSensitivityLabels
POST /groups/{group-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /me/drive/items/{item-id}/extractSensitivityLabels
POST /me/drive/root:/{item-path}:/extractSensitivityLabels
POST /sites/{site-id}/drive/items/{item-id}/extractSensitivityLabels
POST /sites/{site-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /users/{user-id}/drive/items/{item-id}/extractSensitivityLabels
POST /users/{user-id}/drive/root:/{item-path}:/extractSensitivityLabels

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。

请求正文

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

响应

如果成功，此操作将在 200 OK 响应正文中返回响应代码和 extractSensitivityLabelsResult 对象。

除了适用于 Microsoft Graph 的常规错误外，此 API 还 423 Locked 返回响应代码，该代码指示正在访问的文件已锁定。 在这种情况下，响应对象的 code 属性指示阻止敏感度标签提取的错误类型。 下面是错误类型的可能值。

值 说明
fileDoubleKeyEncrypted 指示文件通过双密钥加密进行保护;因此，无法打开它来提取敏感度标签。
fileDecryptionNotSupported 指示加密文件具有不允许 SharePoint 打开这些文件以提取敏感度标签的特定属性。
fileDecryptionDeferred 指示正在处理文件以用于解密;因此，无法打开它来提取敏感度标签。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/extractSensitivityLabels

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "value": {
    "@odata.type": "microsoft.graph.extractSensitivityLabelsResult",
    "labels": [
      {
        "sensitivityLabelId": "5feba255-812e-446a-ac59-a7044ef827b5",
        "assignmentMethod": "standard",
        "tenantId": "fed495cb-8c27-41ea-8749-00b0a084bc3d"
      },
      {
        "sensitivityLabelId": "fa781fdf-68c8-43ec-ae08-c4813deb2144",
        "assignmentMethod": "standard",
        "tenantId": "277601b1-6094-456c-a358-95bfc99539d7"
      },
      {
        "sensitivityLabelId": "3937098d-df0c-4c8d-8f66-5876b57b75ba",
        "assignmentMethod": "standard",
        "tenantId": "f2477f30-c8a2-422d-8995-6f056b494655"
      }
    ]
  }
}