Тип ресурса соглашения
Пространство имен: 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)"
}