You need to enable JavaScript to run this app.
导航

文档预览概述

最近更新时间2023.12.06 10:50:30

首次发布时间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 。
  • 以图片的方式预览表格文件时,一张表格可能分割为多页进行转换,生成多张图片。

文档预览方式

文档预览目前提供 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 的方式预览存储桶的文档文件。