You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

文档预览概述

最近更新时间：2024.03.20 19:30:02

首次发布时间：2023.06.08 11:43:18

我的收藏

TOS 支持以图片、PDF、HTML 的格式预览存储桶的文档文件。您可以通过 GetObject 接口，在请求中携带文档预览的相关参数的方式预览文档文件。

注意

  • 文档预览功能目前处于邀测状态，如您需要使用该功能，请联系客户经理。
  • 文档预览功能暂不收取费用。收费时间及标准会另行通知，请您及时关注相应通知。

使用限制

类别

使用限制

文件类型

仅支持预览以下文件类型：

  • 演示文件：pptx、ppt。
  • 文字文件：docx、doc。
  • 表格文件：xlsm、xls。

注意

仅支持预览 Microsoft Office 文件，如果您使用的是 WPS 等软件生成的文件，使用过程中可能因不兼容导致预览异常等问题，建议您使用 Microsoft Office。

输出格式

仅支持输出 png、jpg、pdf、html 的文件格式。

注意

出于安全合规考虑，从 2022 年 10 月 18 日开始，如果您使用存储桶的默认域名访问网页类型文件（mimetype为 text/html，扩展名包括 HTM、HTML、JSP、PLG、HTX、STM），Response Header 中会自动加上 Content-Disposition:attachment，即从浏览器访问网页类型文件时，将不会直接预览网站，而会将网站的内容下载到本地。

文件大小

预览的文件大小不能超过 200MB 。

表格文件

以图片的方式预览表格文件时，一张表格可能分割为多页进行转换，生成多张图片。

服务端加密

支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的文档进行预览，使用限制如下：

  • 对使用 SSE-C 加密的文档进行预览时，必须携带 SSE-C 的 x-tos-server-side-encryption-customer-algorithm、x-tos-server-side-encryption-customer-key、x-tos-server-side-encryption-customer-key-MD5 头域，关于 SSE-C 头域的详细介绍，请参见使用用户提供密钥的服务端加密（SSE-C）。
  • 不支持匿名预览经过 SSE-KMS 加密的文档，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名预览经过 SSE-KMS 加密的文档。您可以使用预签名、API 预览经过 SSE-KMS 加密的文档，详细介绍，请参见下文的使用 REST API。

文档预览方式

文档预览目前提供 REST API、文件 URL 两种使用方式。您可以对存储在存储桶中的文档以图片、PDF 或 HTML 方式进行预览。

说明

处理后的文件会即时返回，不会保存到您的存储桶中。

  • 使用 REST API，请求示例如下：
GET /example.docx?x-tos-process=doc-preview&x-tos-src-type=docx&x-tos-dst-type=jpg&x-tos-doc-page=1 HTTP/1.1
Host: endpoint
X-Tos-Content-Sha256: sha256
X-Tos-Date: 20220827T132948Z
Authorization: authorization
  • 使用文件 URL

http://bucket.endpoint/example.docx?x-tos-process=doc-preview&x-tos-doc-src-type=docx&x-tos-doc-dst-type=jpg&x-tos-doc-page=1

说明

对于私有文件，需要使用 SDK 生成带文档预览参数的预签名 URL 进行操作。

文档预览功能

文档预览功能

参数

说明

文档预览

doc-preview

以图片、PDF 或 HTML 的方式预览存储桶的文档文件。