使用 Microsoft Graph REST API 在 SharePoint Embedded 中存储和访问文件

6 分钟

创建使用 SharePoint Embedded 的应用程序的开发人员将使用众所周知的和已建立的 Microsoft Graph API 来访问这些容器中的文件和文档。 Microsoft Graph 驱动器终结点可以访问存储在 SharePoint Embedded 容器中的数据。在本部分中，你将了解如何使用 Microsoft Graph REST API 在 SharePoint Embedded Containers 中存储和检索文件和文档。

重要

目前，许多用于创建、访问和管理 SharePoint Embedded 特定资源的 Microsoft Graph 终结点仅存在于 Microsoft Graph beta 终结点上。但是，访问包含中的容器和内容的所有终结点都在 Microsoft Graph v1.0 终结点上。

使用容器

完成提供程序与使用租户之间的所有设置和注册过程后，需要在使用租户中创建容器。

创建新容器

若要创建容器，请使用指定名称、说明和关联的 ContainerType ID 的 JSON 有效负载提交 HTTP POST：

POST https://graph.microsoft.com/beta/storage/fileStorage/containers

{
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "{{ContainerTypeId}}"
}

Microsoft Graph 将使用新容器的详细信息进行响应：

{
  "id": "b!qEMTpi-XGEKZ1W...",
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "3a6b1fc4-0b09-04b3-3a2a-4843fbb60914",
  "status": "inactive",
  "createDateTime": 2023-11-T00:15:25.84Z"
}

列出所有容器

若要获取创建的所有容器的列表，请提交 HTTP GET 请求并按 ContainerType ID 进行筛选：

GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {{ContainerTypeId}}

获取特定容器

若要获取特定容器，请向 Containers 终结点提交 HTTP GET 请求：

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{{ContainerID}}?$select=id,displayName,containerTypeId,status,description,customProperties&$expand=permissions

使用容器的内容

若要在容器中处理内容或文件，你将使用可用于读取和写入 SharePoint 文档库或 OneDrive 的相同 Microsoft Graph 终结点： drives 终结点。这是因为 SharePoint Embedded 容器被视为与 Microsoft Graph Drive 对象相同的对象，并且中的 Drive 文件是 DriveItems。

获取特定容器作为 `Drive` 对象

若要获取特定容器作为驱动器对象，请将 HTTP GET 请求提交到 Microsoft Graph drives 终结点：

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}

若要了解有关 Microsoft Graph drives 终结点的详细信息，请参阅 Microsoft Graph REST API：获取驱动器。

列出容器的内容

若要获取容器的内容，请将 HTTP GET 请求提交到同一终结点，但转到容器的子级：

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/children

将文件上传到容器

若要将文件上传到容器，请将 HTTP POST 请求提交到 drives 终结点，并在请求中包含该文件的内容：

PUT https://graph.microsoft.com/v1.0/drives/{{ContainerId}}/root:/Jan2024.docx:/content

<binary contents of the file>

删除容器的内容

若要从容器中删除文件，请将 HTTP DELETE 请求提交到 drives 终结点：

DELETE https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/{{driveItemID}}

若要详细了解如何使用 Microsoft Graph 处理文件，请参阅 Microsoft Graph REST API：驱动器项。

摘要

创建使用 SharePoint Embedded 的应用程序的开发人员将使用众所周知的和已建立的 Microsoft Graph API 来访问这些容器中的文件和文档。 Microsoft Graph 驱动器终结点可以访问存储在 SharePoint Embedded 容器中的数据。

本部分介绍了如何使用 Microsoft Graph REST API 在 SharePoint Embedded Containers 中存储和检索文件和文档。