上传或替换 driveItem 的内容

命名空间：microsoft.graph

在单个 API 调用中提供新文件的内容或更新现有文件的内容。此方法仅支持最大 250 MB 的文件。

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

权限

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

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

注意

仅应用身份验证不支持替换使用敏感度标签保护的文件的内容。请改用委派权限 (用户上下文) 。

注意

SharePoint Embedded 需要访问 FileStorageContainer.Selected 容器内容的权限。此权限与前面提到的权限不同。除了 Microsoft Graph 权限外，应用还必须具有调用此 API 所需的容器类型权限。有关详细信息，请参阅 SharePoint Embedded 身份验证和授权。

HTTP 请求

替换现有项

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

上传新文件

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drive/items/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
Content-Type	text/plain。必填。

请求正文

请求正文的内容应该是要上载文件的二进制流。

响应

如果成功，此方法将在新创建或更新的文件的响应正文中返回 driveItem 对象。

示例

示例 1：上传新文件

请求

此示例将字符串“The contents of the file goes here.”上传到已登录用户驱动器中名为 FileB.txt 的 FolderA 下的文件。

PUT https://graph.microsoft.com/v1.0/me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

响应

如果成功，此方法将在响应正文中返回新建文件的 driveItem 资源。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

示例 2：更新现有文件

请求

此示例将文件的内容替换为已知 ID。

PUT https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.


const options = {
	authProvider,
};

const client = Client.init(options);

const stream = The contents of the file goes here.;

await client.api('/me/drive/items/{item-id}/content')
	.put(stream);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.Files

$params = The contents of the file goes here.


Set-MgDriveItemContent -DriveId $driveId -DriveItemId $driveItemId -BodyParameter $params