您可以在一个样式(Style)中包含多个处理参数,快速实现复杂的媒体、文档或图片处理操作。本文介绍如何创建和使用样式。
新版数据处理功能API、SDK支持在IMM服务接入点中的地域进行使用。
创建样式
一个存储空间(Bucket)最多可创建50个样式,这些样式仅支持作用于该Bucket下的文件。如您的业务有更多样式的需求,请联系技术支持。
根据您需要处理文件的类型,选择图片处理、文档处理或媒体处理等入口。
选择样式管理页签,单击创建样式。
在创建样式面板,通过图形化方式配置您的样式。
单击确定。
使用样式
样式创建完成后,您可以通过对象URL使用样式来处理文件。
使用对象URL进行同步处理
您可以直接将样式添加到对象访问URL上进行同步处理,格式为http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName
,各参数说明如下表所示。
参数 | 说明 | 示例 |
| 对象的访问地址。获取方式,请参见如何获取单个或多个文件的URL?。 | |
| 固定参数,表示使用样式参数对文件进行处理。 | |
| 创建样式时设置的样式名称。 |
您还可以设置自定义分隔符以及为Bucket绑定自定义域名,以进一步简化处理URL。例如进行如下设置:
使用分隔符
!
代替x-oss-process=style/
。为Bucket绑定自定义域名,进一步简化处理。例如绑定自定义域名
example.com
后,使用https://example.com/example.jpg!small
处理图片。更多信息,请参见绑定自定义域名。
使用样式进行异步处理
您可以对文件进行异步处理时使用样式,示例如下。
POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************
// 使用名为StyleName的样式对文件example.avi进行异步处理,处理后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ
各参数说明如下表所示。
参数 | 说明 |
| 对象的Object名称。 |
| 固定参数,表示使用样式参数对文件进行处理。 |
| 创建样式时设置的样式名称。 |
将源Bucket的样式导入目标Bucket
仅支持图片处理。
您可以导出源Bucket中已创建的样式,并将样式导入到目标Bucket,便于在目标Bucket中快速应用样式来处理图片文件。
在源Bucket中导出样式。
在源Bucket管理页面,选择数据处理>图片处理。
在图片处理页面,单击导出样式。
在弹出的对话框选择样式的保存位置,然后单击保存。
在目标Bucket导入样式。