sensitivityLabel: computeInheritance

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

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

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

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

Разрешения

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

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

HTTP-запрос

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Параметры фильтра

Параметр Тип Описание
applicableTo String Необязательный параметр. Строка, разделенная запятыми, форматов содержимого (например, file, email). Фильтрует возвращаемые метки только к тем, которые применимы по крайней мере к одному из указанных форматов. Возможные значения: email, file, schematizedData, site, teamwork, unifiedGroup.
языковые стандарты String Необязательный параметр. Задает языковой стандарт для локализуемых полей.
labelIds Коллекция строк Необязательный параметр. Коллекция разделенных запятыми строк guid GUID меток конфиденциальности. Фильтрует возвращенные метки только для тех, которые соответствуют указанным идентификаторам.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
Идентификатор запроса клиента Необязательный параметр. Созданный клиентом GUID для трассировки запроса. Рекомендуется для устранения неполадок.

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

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

Отклик

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

Если соответствующая метка не найдена на основе входных данных и фильтров или если возникает ошибка (например, указан недопустимый идентификатор метки), API может вернуть ответ об ошибке (например, 400 Bad Request или 404 Not Found) с подробными сведениями в объекте ошибки.

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/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/v1.0/$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