赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 图片样式(Style)
  8. PutStyle

PutStyle

  • 图片样式(Style)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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

SDK

本接口对应的SDK如下:

  • Python

命令行工具ossutil

PutStyle接口所对应的ossutil命令,请参见put-style。

相关文章

PutStyle 2025-04-21 18:15

调用PutStyle接口新增图片样式。一个图片样式中可以包含单个或多个图片处理参数。 注意事项 阿里云账号默认拥有新增图片样式的权限。如果您希望通过RAM用户或者STS的方式新建图片样式,您必须拥有oss:PutStyle权限。具体操作,请参见为RAM用户授权自定义的

GetStyle 2025-04-21 18:15

调用GetStyle接口查询某个Bucket下指定的样式信息。 注意事项 阿里云账号默认拥有查询某个Bucket下指定样式信息的权限。如果您希望通过RAM用户或者STS的方式进行查询,您必须拥有oss:GetStyle权限。具体操作,请参见为RAM用户授权自定义的权限

ListStyle 2025-04-21 18:15

调用ListStyle接口查询某个Bucket下已创建的所有样式。 注意事项 阿里云账号默认拥有查询某个Bucket下已创建的所有样式的权限。如果您希望通过RAM用户或者STS的方式进行查询,您必须拥有oss:ListStyle权限。具体操作,请参见为RAM用户授权自

DeleteStyle 2025-04-21 18:15

调用DeleteStyle删除某个Bucket下指定的图片样式。 注意事项 阿里云账号默认拥有删除某个Bucket下指定的图片样式的权限。如果您希望通过RAM用户或者STS的方式进行删除,您必须拥有oss:DeleteStyle权限。具体操作,请参见为RAM用户授权自定义的权限策略。 请求

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号