全部产品
Search
文档中心

对象存储 OSS:PutStyle

更新时间:Apr 29, 2024

调用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****