changeTrackedEntity: stageForDeletion
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
在草稿模式下暂存删除计划中的 openShift、shift 或 timeOff 实例。
草稿更改仅对经理可见。 不会向团队成员发送更改草稿通知。 共享计划时,删除操作完成。
权限
要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Schedule.ReadWrite.All | Group.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Schedule.ReadWrite.All | 不可用。 |
HTTP 请求
对于 openShift:
POST /teams/{teamsId}/schedule/openShifts/{openShiftId}/stageForDeletion
对于 班次:
POST /teams/{teamsId}/schedule/shifts/{shiftId}/stageForDeletion
暂时 关闭:
POST /teams/{teamsId}/schedule/timesOff/{timeOffId}/stageForDeletion
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
MS-APP-ACTS-AS | GUID) (用户 ID。 仅当授权令牌是应用程序令牌时才需要;否则为可选。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法返回 204 No Content
响应代码。
示例
示例 1:暂存 openShift 删除
以下示例演示如何在草稿模式下暂存删除计划中的 openShift。
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content
示例 2:暂存删除班次
以下示例演示如何在草稿模式下暂存删除计划中的班次。
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content
示例 3:暂存删除 timeOff
以下示例演示如何在草稿模式下暂存删除计划中的 timeOff。
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈