文档预览
IMM 支持 ppt、xls、doc、pdf 等 48 种格式 的文档在线预览,提供便捷的文档内容管理与访问体验。
参数
操作名称:x-oss-process =imm/previewdoc
名称 | 描述 | 取值范围 |
---|---|---|
copy | 预览文件时,控制是否能够复制文档内容。 值为 1,表示支持复制; 值是 0,表示不支持复制; |
0/1 |
注意事项
文档预览,无论源文件是否公共读,为了安全性考虑都统一采用签名方式使用,所以前端预览流程如下:
- 客户端向服务端发起预览请求,提供要预览的文件;
- 服务端根据请求文件进行 URL 签名,将签名好的 URL 提供到客户端;
- 客户端拿到签名后直接访问 OSS 查看文件;
示例
假如请求 Bucket 是 doc-demo,该 Bucket 在 华东1 区域,对应域名是 oss-cn-hangzhou.aliyuncs.com,请求预览的文档是 example.docx, 通过参数copy=1
配置预览文档内容可复制
http://doc-demo.oss-cn-hangzhou.aliyuncs.com/example.docx?x-oss-process=imm/previewdoc,copy_1
如上 URL 使用 RAM 的 Access KeyID 和 Secret 签名后,得到 SignURL 进行访问。
SDK 请求示例
# -*- coding: utf-8 -*-
import json
import oss2
# Endpoint 以上海为例,其它 Region 请按实际情况填写。
endpoint = 'http://oss-cn-shanghai.aliyuncs.com'
# 阿里云账号拥有所有 API 的访问权限,风险很高。强烈建议您创建并使用 RAM 子账号进行 API 访问或日常运维,请登录 https://ram.console.aliyun.com 创建子账号。
access_key_id = "<acess_key_id>"
access_key_secret = "<acess_key_secret>"
bucket_name = "<bucket_name>"
objectKey = "example.docx"
# 创建存储空间实例,所有文件相关的方法都需要通过存储空间实例来调用。
bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
# 文档预览 获取 signURL
process = 'imm/previewdoc,copy_1'
params = {}
params.update({bucket.PROCESS: process})
url = bucket.sign_url("GET", objectKey, 3600, params=params)
#打印结果
print url
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论