Тип ресурса directoryRoleTemplate
Пространство имен: microsoft.graph
Примечание.
Корпорация Майкрософт рекомендует использовать вместо этого API унифицированный API RBAC. Единый API RBAC обеспечивает большую функциональность и гибкость. Дополнительные сведения см. в разделе Тип ресурса unifiedRoleDefinition.
Представляет шаблон роли каталога. Шаблон роли каталога задает значения свойств роли каталога (directoryRole). Для каждой из ролей каталога, которые могут быть активированы в клиенте, связан объект шаблона роли каталога. Чтобы можно было считать роль каталога или обновить ее членов, сначала следует активировать ее на клиенте. По умолчанию активируется только роль каталога администраторов организации. Чтобы активировать другие доступные роли каталога, отправьте запрос POST в /directoryRoles конечную точку с идентификатором шаблона роли каталога, на котором основана роль каталога, указанного в параметре roleTemplateId запроса. После успешного выполнения этого запроса можно приступить к чтению и назначению участников роли каталога.
Примечание. Шаблон роли каталога предоставляется для роли каталога "Пользователи". Роль каталога Users является неявной и невидимой для клиентов каталогов. Инфраструктура назначает этой роли каждому пользователю в клиенте. Роль уже активирована. Не используйте этот шаблон.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Получение | directoryRoleTemplate | Считывание свойств и отношений объекта directoryRoleTemplate. |
| List | Коллекция объектов directoryRoleTemplate | Получение списка объектов directoryRoleTemplate. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| description | String | Описание, которое нужно задать для роли каталога. Только для чтения. |
| displayName | Строка | Отображаемое имя, которое нужно назначить роли каталога. Только для чтения. |
| id | String | Уникальный идентификатор шаблона. Наследуется из directoryObject. Следует указать свойство id для шаблона роли каталога, чтобы свойство roleTemplateId в запросе POST активировало directoryRole на клиенте. Ключ, значение null не допускается. Только для чтения. |
Связи
Нет
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"description": "string",
"displayName": "string",
"id": "string (identifier)"
}