Тип ресурса соглашения

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

Представляет настраиваемое соглашение об условиях использования клиента, которое создается и управляется с помощью Управление Microsoft Entra ID. Вы можете использовать следующие методы для создания функции Microsoft Entra Условий использования и управления ею в соответствии с вашим сценарием.

Методы

Метод Возвращаемый тип Описание
Список сбор соглашений Получение коллекции объектов соглашения.
Создание соглашение Создайте новое соглашение, опубликовав его в коллекции соглашений.
Получение соглашение Чтение свойств и связей объекта соглашения.
Обновление Нет Обновление объекта соглашения.
удаление; Нет Удаление объекта соглашения.

Свойства

Свойство Тип Описание
displayName String Отображаемое имя соглашения. Отображаемое имя используется для внутреннего отслеживания соглашения, но не отображается конечным пользователям, которые просматривают соглашение. Поддерживает $filter (eq).
id String Идентификатор соглашения. Только для чтения. Поддерживает $filter (eq).
isPerDeviceAcceptanceRequired Логический Указывает, обязаны ли конечные пользователи принимать данное соглашение на каждом устройстве, с которых они получают доступ к нему. Пользователь должен зарегистрировать свое устройство в Microsoft Entra ID, если он еще этого не сделал. Поддерживает $filter (eq).
isViewingBeforeAcceptanceRequired Логический Указывает, должен ли пользователь развернуть соглашение перед принятием. Поддерживает $filter (eq).
termsExpiration termsExpiration Срок действия и частота соглашения для всех пользователей. Поддерживает $filter (eq).
userReacceptRequiredFrequency Duration (Длительность) Длительность, по истечении которой пользователь должен повторно принять условия использования. Значение представлено в формате ISO 8601 для длительности. Поддерживает $filter (eq).

Связи

Связь Тип Описание
Акцепты Коллекция agreementAcceptance Только для чтения. Сведения о принятии настоящего соглашения.
file agreementFile PDF-файл по умолчанию, связанный с этим соглашением.
files коллекция agreementFileLocalization PDF-файлы, связанные с этим соглашением. Это свойство находится в процессе нерекомендуемого использования. Вместо этого используйте свойство file . Поддерживает $expand.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.agreement",
  "displayName": "String",
  "id": "String (identifier)",
  "isPerDeviceAcceptanceRequired": "Boolean",
  "isViewingBeforeAcceptanceRequired": "Boolean",
  "termsExpiration": {
    "@odata.type": "microsoft.graph.termsExpiration"
  },
  "userReacceptRequiredFrequency": "String (duration)"
}