全部產品
Search
文件中心

Object Storage Service:如何建立和使用樣式

更新時間:Apr 26, 2025

您可以在一個樣式(Style)中包含多個處理參數,快速實現複雜的媒體、文檔或圖片處理操作。

說明

新版資料處理功能API、SDK支援在IMM服務存取點中的地區進行使用。

使用自訂樣式

建立樣式

說明

一個儲存空間(Bucket)最多可建立50個樣式,這些樣式僅支援作用於該Bucket下的檔案。如您的業務有更多樣式的需求,請聯絡支援人員

  1. 登入OSS管理主控台

  2. 在左側導覽列,單擊Bucket列表,然後單擊目標Bucket名稱。

  3. 在左側導覽列,選擇數據處理

  4. 根據您需要處理檔案的類型,選擇圖片處理文檔處理ApsaraVideo for Media Processing等入口。

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
 // 使用名為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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
// 使用名為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

系統樣式名稱。

說明

您可以在數據處理>ApsaraVideo for Media Processing頁面查看支援的所有系統樣式參數。

將源Bucket的樣式匯入目標Bucket

說明

僅支援圖片處理樣式。

您可以匯出源Bucket中已建立的樣式,並將樣式匯入到目標Bucket,便於在目標Bucket中快速應用樣式來處理圖片檔案。

  1. 在源Bucket中匯出樣式。

    1. 在源Bucket管理頁面,選擇數據處理>圖片處理

    2. 圖片處理頁面,單擊匯出樣式

    3. 在彈出的對話方塊選擇樣式的儲存位置,然後單擊保存

  2. 在目標Bucket匯入樣式。

    1. 在目標Bucket管理頁面,選擇數據處理>圖片處理

    2. 圖片處理頁面,單擊匯入樣式

    3. 在彈出的對話方塊選擇已匯出的樣式檔案,然後單擊開啟

      樣式匯入完成後,即可在目標Bucket中使用這些樣式處理圖片檔案。

更多參考

  • 關於如何使用處理參數處理檔案,請參見同步處理

  • 關於如何將處理後的檔案持久化地儲存在OSS中,請參見另存新檔