文档预览概述--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

文档预览概述

最近更新时间：2025.01.02 19:04:12首次发布时间：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 的方式预览存储桶的文档文件。