Share via

Получение сведенийProtectionPolicySetting

  • Статья

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

Важно!

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

Чтение свойств и связей объекта informationProtectionPolicySetting . Параметры, предоставляемые этим API, должны использоваться в приложениях для заполнения свойства moreInfoUrl для Защита информации Microsoft Purview справки и указания, является ли маркировка обязательной для пользователя и необходимо ли предоставлять обоснование при переходе на более раннюю версию.

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

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

Разрешения

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

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

HTTP-запрос

Чтобы получить параметры политики, доступные для вошедшего пользователя (делегированное разрешение) или указанного пользователя (разрешение приложения):

GET /users/{usersId}/security/informationProtection/labelPolicySettings
GET /me/security/informationProtection/labelPolicySettings

Чтобы получить параметры политики, доступные организации в качестве субъекта-службы (разрешение приложения):

GET /security/informationProtection/labelPolicySettings

Необязательные параметры запросов

Этот метод поддерживает некоторые параметры запросов OData для настройки отклика. Общие сведения см. в статье Параметры запроса OData.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
User-Agent Описывает имя и версию вызывающего приложения. Подробные сведения появятся в Azure Information Protection Analytics. Рекомендуемый формат — ApplicationName/Version. Необязательный параметр.

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

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект informationProtectionPolicySetting в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/users/bob@contoso.com/security/informationProtection/labelPolicySettings

Отклик

Ниже показан пример отклика.

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

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

{
    "@odata.context": "https://canary.graph.microsoft.com/testprodbetamipdev/$metadata#users('bob%40contoso.com')/security/informationProtection/labelPolicySettings/$entity",
    "id": "BFB31DC0E2183F5872EEC3FEC1A254B8118DF1156CC19E783EA6D36304242B7FCFA4CF1DA3374481AA9919D8F3D63F7C",
    "moreInfoUrl": "https://contoso.com/MIPInfo",
    "isMandatory": false,
    "isDowngradeJustificationRequired": true
}