plannerRoster 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示正在协作处理 plannerPlan 的用户的集合。 plannerRoster 是一组简单的用户，其中每个人都拥有相同级别的权限，并且每个人都可以创建这些权限，除非租户管理员禁用。 plannerRoster 可以包含一个计划。
删除 plannerRoster 还会删除计划和计划中的所有任务。 在以下情况下，也会自动删除 plannerRoster ：
- plannerRoster 在创建后 24 小时不包含计划。 成员身份信息在此删除后的 30 天内被清除。
- plannerRoster 不会在成员身份列表中保留任何用户，因为最后一个用户删除了自己。 在此操作后的 30 天内，将删除名册、其计划和所有包含的任务。
- plannerRoster 不会在成员身份列表中保留任何用户，因为最后一个用户已被永久删除。 名册、其计划和所有包含的任务将立即删除。 删除的用户将在删除后的 30 天内永久擦除;但是，租户管理员还可以选择在无此延迟的情况下永久删除用户。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | plannerRoster | 创建新的 plannerRoster 对象。 |
| Get | plannerRoster | 读取 plannerRoster 对象的属性和关系。 |
| 删除 | 无 | 删除 plannerRoster 对象。 |
| 列出名单成员 | plannerRosterMember 集合 | 从成员导航属性获取 plannerRosterMember 资源。 |
| 将成员添加到名单 | plannerRosterMember | 创建新的 plannerRosterMember 对象。 |
| 在名单中列出计划 | plannerPlan 集合 | 从计划导航属性获取 plannerPlan 资源。 |
| 在名单中列出用户的计划 | plannerPlan 集合 | 获取 plannerRosters 包含的用户是成员的 plannerPlans。 |
| 分配敏感度标签 | plannerRoster] | 将敏感度标签分配给 plannerRoster 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| assignedSensitivityLabel | sensitivityLabelAssignmentMethod | 应用于名册的敏感度标签。 如果为用户启用了强制标签，但未指定标签，则用户无法创建名册。 此外，如果用户必须添加标签，则用户无法将名册的标签更改为 null。 可取值为：standard、privileged、auto、unknownFutureValue。 |
| id | String | plannerRoster 的标识符。 只读。 继承自 实体 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 成员 | plannerRosterMember 集合 | 检索 plannerRoster 的成员。 |
| 计划 | plannerPlan 集合 | 检索 plannerRoster 包含的计划。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.plannerRoster",
"assignedSensitivityLabel": "#microsoft.graph.sensitivityLabelAssignment",
"id": "String (identifier)"
}