所有對圖片的變換都會加在URL後面,會導致URL變得冗長,不方便管理與閱讀。圖片處理服務提供用戶將常見的操作保存成一個別名,即樣式(Style)。一個複雜操作,利用樣式功能後,只要用一個很短的URL就能實現相同的效果。
一個Bucket下面有多個樣式,樣式的作用範圍只在一個Bucket下,目前一個Bucket允許最多有50個樣式。
樣式訪問規則
URL參數方式訪問
<檔案URL>?x-oss-process=style/<StyleName>
樣本:
bucket.aliyuncs.com/sample.jpg?x-oss-process=style/stylename
這種方式是圖片處理預設支援樣式訪問方式。
分隔符號方式訪問
<檔案URL><分隔符號><StyleName>
樣本:
bucket.aliyuncs.com/sample.jpg@!stylename
其中@!
是樣式的分隔符號,在URL帶了這個分隔符號,圖片處理服務會把該分隔符號後面的內容當成樣式的名稱。該方式為圖片處理可選的使用方式,您也可以在控制台設定分隔符號。同時還能支援-
、_
、/
、!
等多種可選樣式分隔符號。
- StyleName表示的是樣式的名字。
- 建立樣式、刪除樣式和修改樣式都在前端控制台實現。
- 當訪問的樣式在指定Bucket不存在時,將返回NotSuchStyle錯誤。
说明 | |
如果使用IMG網域名稱,必須開啟OSS同步功能才能使用分隔符號方式訪問。 |
設定分隔符號
- 在OSS管理主控台左側儲存空間列表中,單擊您要向其中設定分隔符號的儲存空間名稱。
- 單擊圖片處理頁簽,找到訪問設定按鈕。
- 單擊訪問設定,開啟設定視窗。
在設定視窗中您可以進行以下設定:
- 開啟原圖保護:開啟原圖保護後,圖片檔案只能通過傳入stylename和帶簽名的方式訪問;將禁止直接存取OSS 原檔案或傳入圖片參數修改圖片樣式的訪問。
- 自訂分隔符號。
設定好您需要的選項之後單擊確定完成分隔符號的設定。
樣本
假如對image-demo這個bucket建立一個樣式:
樣式名 | 樣式內容 |
---|---|
panda_sytle | image/resize,m_fill,w_300,h_300,limit_0/auto-orient,0/quality,q_90/watermark,image_cGFuZGEucG5n,t_61,g_se,y_10,x_10 |
- 直接參數訪問
- 通過URL參數,使用樣式訪問
http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/panda_style
- 通過樣式分隔符號,使用樣式方式訪問
http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg@!panda_style
三者可以達到同樣的效果。