通过

recycleBinItem： restore

命名空间：microsoft.graph

从 fileStorageContainer 的 recycleBin 还原 recycleBinItem 对象。 可以通过回收idBinItem 或使用原始 driveItemId 作为备用键来还原。

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

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

权限

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

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） FileStorageContainer.Selected 不可用。
委派（个人 Microsoft 帐户） FileStorageContainer.Selected 不可用。
应用程序 FileStorageContainer.Selected 不可用。

注意

除了Microsoft Graph 权限外，应用还必须具有调用此 API 所需的容器类型级权限。 有关详细信息，请参阅 容器类型。 若要详细了解容器类型级权限，请参阅 SharePoint Embedded 授权。

HTTP 请求

POST /storage/fileStorage/containers/{containerId}/recycleBin/items/restore

使用 driveItemId 作为备用键还原单个 recycleBinItem。 如果 driveItemId 没有匹配的 recycleBinItem，API 将返回 404 (找不到) 响应。

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/recycleBin/items(driveItemId='{driveItemId}')/restore

请求标头

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

请求正文

如果通过 还原， recycleBinItemId请在请求正文中提供要还原的 recycleBinItem 对象的 JSON 表示形式。 如果要通过 driveItemId 作为备用键进行还原，则不需要请求正文。

响应

如果成功还原， recycleBinItemId此方法将在响应正文中返回响应 207 Multi-Status 代码和还原的 recycleBinItem 对象集。

如果使用 作为备用键成功还原 driveItemId ，此方法将返回 200 OK 响应代码，其中包含响应正文中还原的单 一 recycleBinItem 的 ID。

示例

示例 1：还原 recycleBinItem

请求

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

POST  https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/restore
Content-Type: application/json

{
  "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"]
}

响应

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

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

HTTP/1.1 207 Multi-Status
Content-Type: application/json

{
  "value": [
    {
      "id": "5d625d33-338c-4a77-a98a-3e287116440c"
    },
    {
      "id": "73133853-48f2-4956-bc4a-03f8d1675042"
    }
  ]
}

示例 2：通过将 driveItemId 还原为备用键的 recycleBinItem

在此示例中， 在 driveItemId 请求 URL 中作为函数参数传递。 响应返回已还原的 的 recycleBinItem 相应 ID。

请求

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/b!LRJHKCBZQU2fLtv8TzUomsz-OP7yGQRNlugra1iGHqRe5fORWrrHTbh8J8O8qPmx/recycleBin/items(driveItemId='01GC3BS4QFPBCZRLJHJVEYPITEHTDBYHBH')/restore
Content-Type: application/json

响应

HTTP/1.1 200 Ok
Content-Type: application/json
{
  "id": "bf7ea563-b848-4ec8-9155-b2054564cfe4"
}

示例 3：无法将 driveItemId 作为备用键还原 recycleBinItem

在此示例中，没有匹配的 recycleBinItem 与指定的 driveItemId 相关联。 API) 响应返回 404 (未找到。

请求

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/e!JDJHKCBZTU2fLtv8TzUoksz-OP7yGQRNlugra1iGHqRe5fORWrrHTbh8J8O8qPmx/recycleBin/items(driveItemId='01jC3BS4QFPBCZRLGHJVEYPITEHTDBYHBP')/restore
Content-Type: application/json

响应

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "NotFound",
    "message": "The requested resource could not be found."
  }
}
  • Last updated on