Use the x-oss-async-process header to submit a processing task in asynchronous mode. Unlike synchronous processing, asynchronous mode lets your application continue running other tasks without waiting for the current task to finish. This is well-suited for long-running operations such as document conversion, video transcoding, and video stitching.
When you submit an asynchronous task, the workflow is:
Submit: Send the request with the
x-oss-async-processheader. OSS accepts the task and returns immediately — the processed output is not included in the response.Save: Use Save As to write the processed output to an OSS bucket.
Get notified: Enable Message Notification to receive task completion status.
Supported operations
Replace the asterisk (*) in each operation with the actual processing parameter. For example, usex-oss-async-process=doc/convertto run document conversion.
| Feature | Operation | References | Methods |
|---|---|---|---|
| Document processing | x-oss-async-process=doc/* | Document conversion | Alibaba Cloud SDK, RESTful APIs |
| Media processing (video) | x-oss-async-process=video/* | Video transcoding, Video-to-animated-image conversion, Generate CSS sprites from video snapshots, Frame capture, Video merging | Alibaba Cloud SDK, RESTful APIs |
| Media processing (audio) | x-oss-async-process=audio/* | Audio transcoding, Audio merging | Alibaba Cloud SDK, RESTful APIs |
What's next
Save As — save processed files to OSS
Message Notification — get notified when asynchronous tasks complete