文档

同步处理

更新时间:

同步处理(x-oss-process)是指程序执行一个任务时,必须等待该任务完成才能继续执行其他任务。同步处理适用于可以快速返回结果的场景,例如图片处理、文档处理等。

支持同步处理的操作

说明

操作名称中的*需替换为对应的处理参数。例如图片缩放的操作名称为x-oss-process=image/resize

功能

操作名称

相关文档

操作方式

图片处理

x-oss-process=image/*

处理参数

  • 文件URL

  • 阿里云SDK

  • REST API

文档处理

x-oss-process=doc/*

  • 阿里云SDK

  • REST API

媒体处理

  • 视频:x-oss-process=video/*

  • 音频:x-oss-process=audio/*

图片智能

x-oss-process=image/*

图片智能

常见问题

同步处理可以同时进行多个操作么?

  • 对于支持匿名访问的同步处理操作,例如图片处理,可以通过文件URL添加多个处理参数的方式,对图片进行多个操作。例如您需要对图片进行缩放并添加水印,可以使用以下文件URL。

    https://examplebucket.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300,h_300/watermark,image_cGFuZGEucG5n,t_90
  • 对于不支持匿名访问的同步处理操作,例如文档处理,可以通过阿里云SDK添加多个处理参数的方式,对文档进行多个操作。以Java SDK为例,通过添加以下处理参数,实现转换文档类型并获取文档快照。

    getObjectRequest.setProcess("doc/convert,target_jpg,source_docx/snapshot,target_jpg,source_docx,page_2");

更多参考

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