签出 DriveItem 资源

签出 driveItem 资源以防止在签入文档前其他人编辑文档和看到所做的更改。

Permissions

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.All
委派(个人 Microsoft 帐户) Files.ReadWrite、Files.ReadWrite.All
应用程序 Files.ReadWrite.All、Sites.ReadWrite.All

HTTP 请求

POST /drives/{driveId}/items/{itemId}/checkout
POST /groups/{groupId}/drive/items/{itemId}/checkout
POST /me/drive/items/{item-id}/checkout
POST /sites/{siteId}/drive/items/{itemId}/checkout
POST /users/{userId}/drive/items/{itemId}/checkout

请求正文

无需请求正文。

示例

本示例签出由 {item-id} 标识的文件。

POST /drives/{drive-id}/items/{item-id}/checkout

响应

如果成功,该 API 调用会返回 204 No Content

HTTP/1.1 204 No Content

注解