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)"
}