調用PutStyle介面新增圖片樣式 - Object Storage Service

調用PutStyle介面新增圖片樣式。一個圖片樣式中可以包含單個或多個圖片處理參數。

注意事項

阿里雲帳號預設擁有新增圖片樣式的許可權。如果您希望通過RAM使用者或者STS的方式建立圖片樣式，您必須擁有oss:PutStyle許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

請求文法

說明

新增圖片樣式時，您需要通過styleName參數指定樣式名稱，例如PUT /?style&styleName=imagestyle HTTP/1.1。

PUT /?style&styleName=styleName HTTP/1.1
Date:  GMT Date
Content-Length: ContentLength
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求元素

名稱

類型

是否必選

樣本值

描述

Style

容器

是

不涉及

儲存Content資訊列表的容器。

父節點：無

子節點：Content

Content

字串

是

image/resize,p_50

圖片樣式內容，圖片樣式可以包含一個或多個圖片處理操作。

包含單個圖片處理操作的圖片樣式，例如image/resize,p_50，表示將原圖縮放50%。
包含多個圖片處理操作的圖片樣式，例如image/resize,p_63/quality,q_90，表示先將圖片縮放到原圖的63%，再設定圖片相對品質為90%。

父節點：Style

子節點：無

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

PUT /?style&styleName=imagestyle HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Content-Length: 63
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Style>
 <Content>image/resize,p_50</Content>
</Style>

返回樣本

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 534B371674E88A4D8906****

SDK

本介面對應的SDK如下：

Python

命令列工具ossutil

PutStyle介面所對應的ossutil命令，請參見put-style。