创建 timeOffRequest

命名空间:microsoft.graph

创建 timeoffrequest 对象的实例。

API 可用性

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ❌ ❌ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Schedule.ReadWrite.All 不可用。
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 Schedule.ReadWrite.All 不可用。

HTTP 请求

POST /teams/{teamId}/schedule/timeOffRequests

可选的查询参数

此方法不支持使用 OData 查询参数来自定义响应。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-type application/json. 必需。
MS-APP-ACTS-AS (已弃用) 用户 ID (GUID) 。 仅当授权令牌是应用程序令牌时才需要;否则为可选。 MS-APP-ACTS-AS标头已弃用,不再需要应用程序令牌。

请求正文

在请求正文中,提供新 timeoffrequest 对象的 JSON 表示形式。

响应

如果成功,此方法将在响应正文中返回 200 OK 响应代码和创建的 timeoffrequest 对象。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timeOffRequests

{
  "senderMessage": "Need a break",
  "timeOffReasonId": "TOR_08c42f26-9b83-492c-bf52-f3609eb083e3",
  "senderUserId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "startDateTime": "2025-05-26T07:00:00Z",
  "endDateTime": "2025-05-27T07:00:00Z"
}

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "SREQ_54f7ae3c-dc28-4773-8135-811dd8db2121",
    "createdDateTime": "2025-05-22T20:50:26.796Z",
    "lastModifiedDateTime": "2025-05-22T20:50:26.796Z",
    "assignedTo": "manager",
    "state": "pending",
    "senderDateTime": "2025-05-22T20:50:26.796Z",
    "senderMessage": "Need a break",
    "senderUserId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
    "managerActionDateTime": null,
    "managerActionMessage": null,
    "managerUserId": null,
    "startDateTime": "2025-05-26T07:00:00Z",
    "endDateTime": "2025-05-27T07:00:00Z",
    "timeOffReasonId": "TOR_08c42f26-9b83-492c-bf52-f3609eb083e3",
    "lastModifiedBy": {
        "user": {
            "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
            "displayName": "Ava Mitchell",
            "userIdentityType": "aadUser",
        }
    }
}