directoryRoleTemplate 资源类型

命名空间:microsoft.graph

注意

Microsoft建议使用统一的 RBAC API 而不是此 API。 统一的 RBAC API 提供更多的功能和灵活性。 有关详细信息,请参阅 unifiedRoleDefinition 资源类型

表示目录角色模板。 目录角色模板指定目录角色的属性值 (directoryRole) 。 对于可在租户中激活的每个目录角色,都有关联的目录角色模板对象。 要读取目录角色或更新其成员,首先必须在租户中将其激活。 默认情况下,仅激活公司管理员目录角色。 若要激活其他可用的目录角色,请使用请求的 roleTemplateId 参数中指定的目录角色模板的 ID 向/directoryRoles终结点发送 POST 请求。 成功完成此请求后,可以开始读取成员并将其分配到目录角色。 注意:为用户目录角色公开目录角色模板。 用户目录角色是隐式的,对目录客户端不可见。 租户中的每个用户都由基础结构分配给此角色。 角色已激活。 请勿使用此模板。

方法

方法 返回类型 说明
Get directoryRoleTemplate 读取 directoryroletemplate 对象的属性和关系。
List directoryRoleTemplate 集合 检索 directoryRoleTemplate 对象的列表。

属性

属性 类型 说明
说明 String 可设置目录角色说明。 只读。
displayName String 可设置目录角色显示名称。 只读。
id String 模板的的唯一标识符。 继承自 directoryObject。 在 POST 请求中指定 roleTemplateId 属性的目录角色模板的 id 将在租户中激活 directoryRole。 密钥,不可为 NULL。 只读。

关系

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)"
}