您可以在一個樣式(Style)中包含多個處理參數,快速實現復雜的媒體、文檔或圖片處理操作。本文介紹如何創建和使用樣式。
新版數據處理功能API、SDK支持在IMM服務接入點中的地域進行使用。
創建樣式
一個存儲空間(Bucket)最多可創建50個樣式,這些樣式僅支持作用于該Bucket下的文件。如您的業務有更多樣式的需求,請聯系技術支持。
根據您需要處理文件的類型,選擇圖片處理、文檔處理或媒體處理等入口。
選擇樣式管理頁簽,單擊創建樣式。
在創建樣式面板,通過圖形化方式配置您的樣式。
單擊確定。
使用樣式
樣式創建完成后,您可以通過對象URL使用樣式來處理文件。
使用對象URL進行同步處理
您可以直接將樣式添加到對象訪問URL上進行同步處理,格式為http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName
,各參數說明如下表所示。
參數 | 說明 | 示例 |
| 對象的訪問地址。獲取方式,請參見如何獲取單個或多個文件的URL?。 | |
| 固定參數,表示使用樣式參數對文件進行處理。 | |
| 創建樣式時設置的樣式名稱。 |
您還可以設置自定義分隔符以及為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 qn6q**************:77Dv****************
// 使用名為StyleName的樣式對文件example.avi進行異步處理,處理后將得到的文件保存為oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ
各參數說明如下表所示。
參數 | 說明 |
| 對象的Object名稱。 |
| 固定參數,表示使用樣式參數對文件進行處理。 |
| 創建樣式時設置的樣式名稱。 |
將源Bucket的樣式導入目標Bucket
僅支持圖片處理。
您可以導出源Bucket中已創建的樣式,并將樣式導入到目標Bucket,便于在目標Bucket中快速應用樣式來處理圖片文件。
在源Bucket中導出樣式。
在源Bucket管理頁面,選擇數據處理>圖片處理。
在圖片處理頁面,單擊導出樣式。
在彈出的對話框選擇樣式的保存位置,然后單擊保存。
在目標Bucket導入樣式。