如何创建和使用样式_对象存储(OSS)-阿里云帮助中心

您可以在一个样式（Style）中包含多个处理参数，快速实现复杂的媒体、文档或图片处理操作。本文介绍如何创建和使用样式。

说明

新版数据处理功能API、SDK支持在IMM服务接入点中的地域进行使用。

创建样式

说明

一个存储空间（Bucket）最多可创建50个样式，这些样式仅支持作用于该Bucket下的文件。如您的业务有更多样式的需求，请联系技术支持。

登录OSS管理控制台。
在左侧导航栏，单击Bucket列表，然后单击目标Bucket名称。
在左侧导航栏，选择数据处理。
根据您需要处理文件的类型，选择图片处理、文档处理或媒体处理等入口。
选择样式管理页签，单击创建样式。
在创建样式面板，通过图形化方式配置您的样式。
单击确定。

使用样式

样式创建完成后，您可以通过对象URL使用样式来处理文件。

使用对象URL进行同步处理

您可以直接将样式添加到对象访问URL上进行同步处理，格式为http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName，各参数说明如下表所示。

参数	说明	示例
`http(s)://BucketName.Endpoint/ObjectName`	对象的访问地址。获取方式，请参见如何获取单个或多个文件的URL？。	https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/small
`x-oss-process=style/`	固定参数，表示使用样式参数对文件进行处理。
`StyleName`	创建样式时设置的样式名称。

说明

您还可以设置自定义分隔符以及为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 qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
 
 // 使用名为StyleName的样式对文件example.avi进行异步处理，处理后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

各参数说明如下表所示。

参数	说明
`/ObjectName`	对象的Object名称。
`x-oss-async-process=style/`	固定参数，表示使用样式参数对文件进行处理。
`StyleName`	创建样式时设置的样式名称。

将源Bucket的样式导入目标Bucket

说明

仅支持图片处理。

您可以导出源Bucket中已创建的样式，并将样式导入到目标Bucket，便于在目标Bucket中快速应用样式来处理图片文件。

在源Bucket中导出样式。
1. 在源Bucket管理页面，选择数据处理>图片处理。
2. 在图片处理页面，单击导出样式。
3. 在弹出的对话框选择样式的保存位置，然后单击保存。
在目标Bucket导入样式。
1. 在目标Bucket管理页面，选择数据处理>图片处理。
2. 在图片处理页面，单击导入样式。
3. 在弹出的对话框选择已导出的样式文件，然后单击打开。
  样式导入完成后，即可在目标Bucket中使用这些样式处理图片文件。

创建样式

使用样式

使用对象URL进行同步处理

使用样式进行异步处理

将源Bucket的样式导入目标Bucket

更多参考