Поделиться через

userProtectionScopeContainer: compute

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Вычисление политик защиты данных и действий, применимых к конкретному пользователю в зависимости от контекста.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) ProtectionScopes.Compute.User ProtectionScopes.Compute.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение ProtectionScopes.Compute.User ProtectionScopes.Compute.All

HTTP-запрос

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Примечание.

Для вызова конечной точки /me требуется вход пользователя и, следовательно, делегированное разрешение. Разрешения приложений не поддерживаются при использовании конечной /me точки.

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

Примечание.

Если у вас есть только userPrincipalName пользователя, используйте следующий URL-адрес для получения идентификатора объекта.

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

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
If-None-Match Необязательный параметр. Это значение используется API для определения того, изменилось ли состояние политики с момента последнего вызова API.
Идентификатор запроса клиента Строка (рекомендуется GUID). Необязательный параметр. Уникальный идентификатор для этого запроса, который используется для трассировки и отладки в журналах и поддержки взаимодействий. Если идентификатор не указан, он может быть создан автоматически. Рекомендуется указать идентификатор, чтобы упростить трассировку и отладку. В ответе возвращается тот же идентификатор, который был отправлен в запросе.

Текст запроса

В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.

Параметр Тип Описание
activities microsoft.graph.security.userActivityTypes Необязательный параметр. Флаги, указывающие действия пользователя, поддерживаемые вызывающим приложением или интересующие его. Возможные значения: none, uploadText, uploadFile, downloadText, downloadFile, unknownFutureValue. Этот объект является многозначным перечислением.
deviceMetadata deviceMetadata Необязательный параметр. Сведения об устройстве пользователя (тип, ОС), используемом для оценки контекстной политики.
integratedAppMetadata integratedApplicationMetadata Необязательный параметр. Сведения о вызывающем приложении (имя, версия), интегрируемом с Microsoft Purview.
locations Коллекция policyLocation Необязательный параметр. Список конкретных расположений, в которые заинтересовано приложение. Если это указано, результаты обрезаются по политикам, охватывающим эти расположения. Используйте приложение расположения политики для расположений приложений, домен расположения политики для доменных расположений или URL-адрес расположения политики для расположений URL-адресов. Необходимо указать @odata.type свойство для объявления типа policyLocation. Например, "@odata.type": "microsoft.graph.policyLocationApplication".
Сводный раздел microsoft.graph.policyPivotProperty Необязательный параметр. Указывает способ агрегирования результатов. Если опущен или none, результаты могут быть менее агрегированными. Возможные значения: activity,location . none

Заголовки откликов

Имя Описание
Etag Индикатор изменения состояния политики, настроенной администратором. Если Etag соответствует значению If-None-Match и вы кэшировали результаты анализа предыдущих результатов из этого API, нет необходимости анализировать ответ и кэшировать проанализированные результаты. Кэшируйте это значение для вызовов для обработки содержимого.

Отклик

В случае успешного 200 OK выполнения это действие возвращает код отклика и коллекцию объектов policyUserScope в теле отклика. Каждый объект представляет набор расположений и действий, управляемых общим набором действий политики и режима выполнения для указанного пользователя.

Примеры

Запрос

В следующем примере вычисляется область защиты для пользователя, выполняющего отправку текста, интересующегося определенным доменом и сводя результаты по действиям.

POST https://graph.microsoft.com/beta/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"
      }
   ]
}

Отклик

Ниже показан пример отклика. Он указывает, что для действия в uploadTextpublic.contoso.comполитикам требуется встроенная оценка и активация browserRestriction действия (вероятно, блокирует отправку на основе конфиденциального содержимого).

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.policyUserScope)",
  "value": [
    {
      "activities": "uploadText,downloadText",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    }
  ]
}
  • Last updated on