赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 操作指南
  5. 数据处理
  6. 基本概念
  7. 功能配置
  8. 样式

样式

  • 功能配置
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

您可以在一个样式(Style)中包含多个处理参数,快速实现复杂的媒体、文档或图片处理操作。

说明

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

使用自定义样式

创建样式

说明

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

  1. 登录OSS管理控制台。

  2. 在左侧导航栏,单击Bucket列表,然后单击目标Bucket名称。

  3. 在左侧导航栏,选择数据处理。

  4. 根据您需要处理文件的类型,选择图片处理、文档处理或媒体处理等入口。

  5. 选择样式管理页签,单击创建样式。

  6. 在创建样式面板,通过图形化方式配置您的样式。

  7. 单击确定。

使用样式

样式创建完成后,您可以通过对象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

创建样式时设置的样式名称。

您可以设置自定义分隔符和绑定自定义域名以简化处理URL,例如进行如下设置:

  • 使用分隔符!代替x-oss-process=style/

  • 为Bucket绑定自定义域名,进一步简化处理,更多信息,请参见绑定自定义域名

例如绑定自定义域名example.com后,使用https://example.com/example.jpg!small处理图片。

说明

现在必须通过绑定域名。自2022年10月09日00:00:00起,创建的bucket不支持在线预览。若不绑定域名,无法实现在线预览功能。更多信息,请参见公告。

使用样式进行异步处理

您可以使用x-oss-async-process=style/StyleName对文件进行异步处理,示例如下:

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

各参数说明如下表所示:

参数

说明

ObjectName

Object名称。

x-oss-async-process=style/

固定参数,表示使用样式参数对文件进行处理。

StyleName

创建样式时设置的样式名称。

使用系统样式

除了使用自定义样式,您还可以使用系统样式处理文件。

使用样式进行异步处理

您可以通过x-oss-async-process=style/::systemStyleName对文件进行异步处理,示例如下:

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****************
 
// 使用名为h264-mp4-1080p的系统样式对文件example.avi进行异步处理,处理后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

各参数说明如下表所示:

参数

说明

ObjectName

Object名称。

x-oss-async-process=style/

固定参数,表示使用样式参数对文件进行处理。

:: 

使用系统样式。

systemStyleName

系统样式名称。

说明

您可以在数据处理>媒体处理页面查看支持的所有系统样式参数。

将源Bucket的样式导入目标Bucket

说明

仅支持图片处理样式。

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

  1. 在源Bucket中导出样式。

    1. 在源Bucket管理页面,选择数据处理>图片处理。

    2. 在图片处理页面,单击导出样式。

    3. 在弹出的对话框选择样式的保存位置,然后单击保存。

  2. 在目标Bucket导入样式。

    1. 在目标Bucket管理页面,选择数据处理>图片处理。

    2. 在图片处理页面,单击导入样式。

    3. 在弹出的对话框选择已导出的样式文件,然后单击打开。

      样式导入完成后,即可在目标Bucket中使用这些样式处理图片文件。

更多参考

  • 关于如何使用处理参数处理文件,请参见同步处理。

  • 关于如何将处理后的文件持久化地保存在OSS中,请参见另存为。

相关文章

样式 2025-04-21 18:16

您可以在一个样式(Style)中包含多个处理参数,快速实现复杂的媒体、文档或图片处理操作。 说明 新版数据处理功能API、SDK支持在IMM服务接入点中的地域进行使用。

任务 2025-04-21 18:16

异步处理以任务的形式对文件进行处理,请求完成时会返回任务ID,之后可以通过任务ID查询任务状态。本文介绍如何使用异步任务进行文件处理。 说明 新版数据处理功能API、SDK支持通过IMM服务

批处理 2025-04-21 18:16

使用批处理对存储空间(Bucket)中存量文件进行批量处理。例如将Bucket某个目录中后缀为.docx的文件转换成PDF格式、将所有MOV格式的文件转码为MP4等。 说明 新版数据处理功能API、SD

触发器 2025-04-21 18:16

使用触发器可以对存储空间(Bucket)中的增量文件进行批量处理。例如,您可以将新增的.docx文件转换成.pdf格式,或将.mov文件转码为.mp4等。与批处理不同,触发器只会对创建触发器之后OSS内新增的文件进行处理,而不会处理存量文件。 说明

管道 2025-04-21 18:16

管道是一种可以实现多种处理任务顺序执行的机制。您可以通过管道将多个处理任务串联起来,依次对文件进行不同的处理。 访问规则 URL通过处理参数

变量 2025-04-21 18:16

在使用数据处理功能时,每个Object都会触发一个任务,任务中需要指定处理后的文件保存路径。为了避免文件覆盖,需要保证输出路径为动态路径。您可以在输出路径中引用源文件的信息,如Bucket、文件名、上传时间等。例如:将视频截帧任务的输出路径指定为oss://test-bucket/{dirname}

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号