对象存储 OSS：变量

控制台使用场景

• 任务：处理任务可在输出路径中引用源文件信息。例如：文档转jpg图片任务，输出路径设置为oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}，处理时{autoext}将被替换为jpg，转换生成的图片保存路径为oss://test-bucket/output/源文件目录/源文件名/图片序号.jpg。

  在创建任务弹窗中，样式选择 doc_to_jpg。输出路径下方提示：需填写完整文件名，文件名支持使用变量，且应避免输入输出路径同名。通知配置区域可选择消息队列，完成后单击确定。

• 批处理：批处理创建成功后会对每个存量文件生成任务。为避免数据覆盖，建议在输出路径中设置变量。例如：视频截帧批处理将视频截帧为png格式，输出路径设置为oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}，处理时{autoext}将被替换为png，处理后生成的png图片保存路径为oss://test-bucket/output/源文件目录/源文件名/图片序号.png。

  在输出配置区域完成输出路径设置后，注意使用 key、barename、basename 变量时需确认输出文件和输入文件路径不同，否则将导致源文件被覆盖以及循环触发。在权限配置区域，服务角色选择 AliyunIMMBatchTriggerRole（默认角色），然后单击确定。

• 触发器：触发器创建成功后会对每个新增文件生成任务。为避免文件覆盖，建议在输出路径中设置变量。例如：文档转换触发器将文档转换为jpg图片格式，将输出路径设置为oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}，处理时{autoext}将被替换为jpg，处理后生成的jpg图片文件保存路径为oss://test-bucket/output/源文件目录/源文件名/图片序号.jpg。

  配置输出路径时需注意：使用 key、barename、basename 变量时应确保输出文件路径与输入文件路径不同，以避免文件覆盖。在权限配置区域，服务角色选择 AliyunIMMBatchTriggerRole（默认角色），然后单击确定。

API使用场景

• 另存为 (sys/saveas)：另存为 (sys/saveas) 中的b（Bucket）和o（Object）参数支持变量。例如：您在对example.docx文档进行文档转换处理时，需要将1~10页分别转换为png格式，可以将sys/saveas设置为b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw（e2J1Y2tldH0是{bucket}进行Base64编码之后的值，ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw是doc_images/{index}.png编码之后的值），则转换后生成的图片保存到源文件相同的Bucket下，路径为doc_images/下标.png。

• 任务：任务的输出路径支持变量。例如：调用创建文档转换任务接口创建文档转换任务时，TargetURI参数必须填写包含扩展名的完整输出文件路径，TargetURI使用变量（例如：oss://test-bucket/output/{dirname}/{barename}/{index}.jpg）。

示例一：文档格式转换

如下REST API示例在PostObject接口中以添加处理参数的方式对example.docx进行文档格式转换处理，在另存为 (sys/saveas) 中的b（Bucket）和o（Object）参数使用变量。

• pages_MS0xMA：转换文档1-10页（MS0xMA是1-10进行Base64编码之后的值）。

• target_png：将文档转换成png图片格式。

• source_docx：指定源文件类型为docx。

• sys/saveas：另存为。

  • b_e2J1Y2tldH0：转码完成后将得到的图片使用{bucket}变量保存到源Bucket（e2J1Y2tldH0是{bucket}进行Base64编码后的值）。

  • o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw：object使用{index}变量以example.docx页码作为图片文件名保存到doc_images目录下（ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw是doc_images/{index}.png进行Base64编码之后的值）。

POST /exmaple.docx?x-oss-async-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 // 将文件example.docx的1-10页转换为PNG格式的图片文件，转换后的存储路径为：oss://源Bucket/doc_images/页码.png。
x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

示例二：视频转码

如下以视频转码处理场景为，对example.avi文件进行视频转码处理，配置了多个处理参数。

• f_mp4：转码输出媒体文件容器为MP4。

• vcodec_h265：视频流格式为H.265。

• s_1920x1080：分辨率为1920x1080。

• vb_2000000：视频码率为2 Mbps。

• fps_30：视频帧率为30 fps。

• acodec_aac：音频编码格式为AAC。

• ab_100000：音频码率为100 Kbps。

• sn_1：禁用字幕流。

• sys/saveas 另存为。

  • b_e2J1Y2tldH0：转码完成后将得到的文件使用{bucket}变量保存到源Bucket（e2J1Y2tldH0是{bucket}进行Base64编码后的值）。

  • o_b3V0cHV0LnthdXRvZXh0fQ：object使用{autoext}变量自动添加后缀，保存后的object为output.mp4（b3V0cHV0LnthdXRvZXh0fQ是output.{autoext}进行Base64编码后的值）。

POST /exmaple.avi?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_e2J1Y2tldH0,o_b3V0cHV0LnthdXRvZXh0fQ