directoryRoleTemplate 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
注意
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)"
}