directoryRoleTemplate 资源类型directoryRoleTemplate resource type

表示目录角色模板。目录角色模板指定目录角色 (directoryRole) 的属性值。租户中每个已激活的目录角色都有一个相关的目录角色模板对象。要读取目录角色或更新其成员,首先必须在租户中将其激活。默认情况下,仅激活公司管理员目录角色。要激活其他可用目录角色,发送 POST 请求到此目录角色模板 ID 的 /directoryRoles 端点,角色基于此模板,且此模板在请求的 roleTemplateId 参数中指定。在成功完成请求后,你可以开始读取,并将成员分配给目录角色。注意:目录角色模板针对用户目录角色公开。用户目录角色是隐式的,对目录客户端不可见。租户中的每个用户按基础结构分配到此角色。已激活该角色。请勿使用此模板。Represents a directory role template. A directory role template specifies the property values of a directory role (directoryRole). There is an associated directory role template object for each of the directory roles that may be activated in a tenant. To read a directory role or update its members, it must first be activated in the tenant. Only the Company Administrators directory role is activated by default. To activate other available directory roles you send a POST request to the /directoryRoles endpoint with the ID of the directory role template on which the directory role is based specified in the roleTemplateId parameter of the request. Upon successful completion of this request, you can then start to read and assign members to the directory role. Note: A directory role template is exposed for the Users directory role. The Users directory role is implicit and is not visible to directory clients. Every User in the tenant is assigned to this role by the infrastructure. The role is already activated. Do not use this template.

方法Methods

方法Method 返回类型Return Type 说明Description
获取 directoryRoleTemplateGet directoryRoleTemplate directoryRoleTemplatedirectoryRoleTemplate 读取 directoryroletemplate 对象的属性和关系。Read properties and relationships of directoryRoleTemplate object.
列出 directoryRoleTemplateList directoryRoleTemplate directoryRoleTemplate 集合directoryRoleTemplate collection 检索 directoryRoleTemplate 对象的列表。Retrieve a list of directoryRoleTemplate objects.

属性Properties

属性Property 类型Type 说明Description
说明description StringString 可设置目录角色说明。只读。The description to set for the directory role. Read-only.
displayNamedisplayName StringString 可设置目录角色显示名称。只读。The display name to set for the directory role. Read-only.
idid 字符串String 模板的的唯一标识符。继承自 directoryObject。在 POST 请求中指定 roleTemplateId 属性的目录角色模板的 id 将在租户中激活 directoryRole。密钥,不可为 NULL。只读。The unique identifier for the template. Inherited from directoryObject. You specify the id of the directory role template for the roleTemplateId property in the POST request activate a directoryRole in a tenant. Key, Not nullable. Read-only.

关系Relationships

None

JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource

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