userProtectionScopeContainer: 计算

命名空间:microsoft.graph

根据特定用户的上下文计算适用于特定用户的数据保护策略和操作。

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

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

权限

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

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 ProtectionScopes.Compute.User ProtectionScopes.Compute.All

HTTP 请求

POST /me/dataSecurityAndGovernance/protectionScopes/compute

注意

调用 /me 终结点需要已登录的用户,因此需要委派权限。 使用 /me 终结点时,不支持应用程序权限。

POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute

注意

如果只有用户的 userPrincipalName,请使用以下 URL 检索其对象 ID。

GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}?$select=id

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
客户端请求 ID 建议) (GUID 字符串。 可选。 此请求的唯一标识符,用于在日志和支持交互中跟踪和调试。 如果未提供 ID,系统可能会自动生成一个 ID。 建议指定 ID 以简化跟踪和调试。 在响应中返回请求中发送的相同 ID。

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

参数 类型 说明
activities microsoft.graph.security.userActivityTypes 可选。 指定调用应用程序支持或感兴趣的用户活动。 此带标志的枚举允许同时选择多个成员。 可取值包括:none、uploadText、uploadFile、downloadText、downloadFile、unknownFutureValue、copyToClipboard、pasteFromClipboard、print、accessDebugTools。 使用Prefer: include-unknown-enum-members请求标头获取此可进化枚举中的以下值: copyToClipboard, , pasteFromClipboardprintaccessDebugTools, .
deviceMetadata deviceMetadata 可选。 有关用于上下文策略评估的用户设备 (类型、OS) 的信息。
integratedAppMetadata integratedApplicationMetadata 可选。 有关调用应用程序 (名称、版本) 与 Microsoft Purview 集成的信息。
位置 policyLocation 集合 可选。 应用程序感兴趣的特定位置的列表。 如果提供,则结果将剪裁到涵盖这些位置的策略。 对应用程序位置使用 策略位置应用程序 ,对域位置使用 策略位置域 ,对 URL 位置使用 策略位置 URL 。 您必须指定属性来 @odata.type 声明 policyLocation 的类型。 例如,"@odata.type": "microsoft.graph.policyLocationApplication"。
pivotOn microsoft.graph.policyPivotProperty 可选。 指定应如何聚合结果。 如果省略 OR none,结果的聚合性可能较低。 可能的值为 activity,location、 none。

响应标头

名称 说明
ETag 管理员配置的策略状态是否已更改的指示器。 如果缓存了 Etag 值,并且该值与此 API 之前结果的 ETag 匹配,则无需解析响应并缓存已解析结果。 缓存此值以进行 对处理内容的调用。

响应

如果成功,此操作将在响应正文中返回 200 OK 响应代码和 policyUserScope 对象的集合。 每个对象都表示一组位置和活动,这些位置和活动受一组通用策略操作和指定用户的执行模式管理。

示例

示例 1:企业应用的计算保护范围

请求

以下示例计算为执行文本上传和下载的用户计算保护范围。

POST https://graph.microsoft.com/v1.0/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
   "activities": "uploadText,downloadText",
   "locations": [
      {
         "@odata.type": "microsoft.graph.policyLocationApplication",
         "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
      }
   ]
}

响应

以下示例显示了相应的响应。 它指示对于 uploadText ID 为 83ef208a-0396-4893-9d4f-d36efbffc8bd 的集成应用程序的活动,策略需要内联评估。 对于 uploadFile ID 为 83ef208a-0396-4893-9d4f-d36efbffc8bd 的集成应用程序的活动,策略需要脱机评估并触发可能 restrictAccess 基于上下文信息阻止上传 (操作;例如,阻止特定用户或组) 的上传。

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

HTTP/1.1 200 OK
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyUserScope)",
  "value": [
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": [
        {
            "@odata.type": "#microsoft.graph.restrictAccessAction",
            "action": "restrictAccess",
            "restrictionAction": "block"
        }
     ]
    }
  ]
}

示例 2:网络提供商应用的计算保护范围

请求

以下示例计算了与特定应用程序相关的文本上传和下载以及文件上传和下载的租户范围保护范围。

POST https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json

{
    "activities": "uploadText,downloadText, uploadFile,downloadFile"
}

响应

以下示例显示了相应的响应。 它指示 'subdomain.domain1.com“、”domain2.com' 或https://subdomain.domain3.com/content/subcontent '' 的 uploadText、downloadText、uploadFile 或 downloadFile 活动需要脱机评估。 针对“subdomain.domain1.com”、“domain2.com”或https://subdomain.domain3.com/content/subcontent“”的 UploadText 活动需要内联评估。

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

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyTenantScope)",
  "value": [
    {
      "activities": "uploadText,uploadFile,downloadText,downloadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    }
  ]
}