PutStyle - 对象存储 OSS

调用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: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 63
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
<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****