老版图片服务手册提供的样式操作有哪些_对象存储(OSS)-阿里云帮助中心

图片服务提供了一些样式（Style）相关的操作，用于增删查改Style。

Put Style

在某个频道（Channel）下，创建一个Style，将复杂的图片服务的处理参数保存成一个样式。创建样式后，通过样式实现与参数同样的图片处理效果。

请求语法

PUT /?style&styleName=YourStyleName  HTTP/1.1
Host: ChannelName.img-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<Style>
<Content>100w_200h.jpg</Content>
</Style>

请求参数（Request Parameters）

参数名称	说明	是否必须	取值范围
styleName	待创建的Style的名称	是	参见Style命名规则

请求元素（Request Elements）

参数名称	说明	是否必须	取值范围
Content	Style对应的内容，表示处理图像所用的参数	是	参见图像处理参数

请求示例

PUT /?style&styleName=style-example HTTP/1.1
Host: channel-example.img-cn-hangzhou.aliyuncs.com  
Date: Thu, 08 Jan 2015 06:17:55 GMT
Authorization: OSS qn6q**************:77Dv****************

<?xml version="1.0" encoding="UTF-8"?>
<Style>
<Content>100w_200h.jpg</Content>
</Style>

返回示例

HTTP/1.1 200 OK 
x-img-request-id: 54AE211379B222C77F000016
Date: Thu, 08 Jan 2015 06:17:55 GMT
Connection: close
Content-Length: 0  
Server: AliyunOSS

细节分析

如果Channel不存在，返回404 Not Found错误，错误码：NoSuchChannel。
每个Channel下最多能创建50个Style。如果超过50个，创建Style时返回403 Forbidden错误，错误码：AccessDenied，错误消息为：Your style count is exceeded 50。
只有Channel的拥有者才能在该Channel下创建Style。如果试图在一个不属于自己的Channel下创建Style，返回403 Forbidden错误，错误码：AccessDenied。
如果待创建的Style已经存在，则会更新原有的Style 。

List Style

List Style可以获取某个频道（Channel）下的所有样式（Style）的信息。

请求语法

GET /?style HTTP/1.1
Host: ChannelName.img-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素（Response Elements）

参数名称	说明
Name	Style名称
Content	Style对应的内容
CreateTime	Style创建时间
LastModifyTime	Style最后修改的时间

请求示例

GET /?style HTTP/1.1
Host: channel-example.img-cn-hangzhou.aliyuncs.com
Date: Thu, 08 Jan 2015 06:28:02 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK 
x-img-request-id: 54AE237279B222C77F000023
Date: Thu, 08 Jan 2015 06:28:02 GMT
Connection: close
Content-Type : application/xml
Content-Length: 568  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<StyleList>
  <Style>
    <Name>style-example1</Name>                    
    <Content>400w</Content>
    <CreateTime> Thu, 08 Jan 2015 06:28:02 GMT </CreateTime>               
    <LastModifyTime> Thu, 08 Jan 2015 06:28:02 GMT</LastModifyTime>
  </Style>
  <Style>
    <Name>style-example2</Name>                    
    <Content>400w</Content>
    <CreateTime>Thu, 08 Jan 2015 06:28:02 GMT</CreateTime>               
    <LastModifyTime> Thu, 08 Jan 2015 06:28:02 GMT</LastModifyTime>
  </Style>
</StyleList>

细节分析

如果频道（Channel）不存在，返回404 Not Found错误，错误码：NoSuchChannel。
只有频道（Channel）的拥有者才能获取该频道（Channel）下的样式。如果试图在一个不属于自己的频道（Channel）下List Style，返回403 Forbidden错误，错误码：AccessDenied。

Get Style

Get Style可以获取某个样式（Style）的属性信息，包括样式名称、内容、创建和最后修改时间。

请求语法：

GET /?style&styleName=YourStyleName HTTP/1.1
Host: ChannelName.img-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求参数（Request Parameters）

参数名称	说明	是否必须	取值范围
styleName	需要获取的Style的名称	是	参见style命名规则

响应元素（Response Elements）

参数名称	说明
Name	Style名称
Content	Style对应的内容
CreateTime	Style创建时间
LastModifyTime	Style最后修改的时间

请求示例

GET /?style&styleName=style-example HTTP/1.1
Host: channel-example.img-cn-hangzhou.aliyuncs.com
Date: Thu, 08 Jan 2015 06:20:12 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK 
x-img-request-id: 54AB9937B703C78879000167 
Date: Thu, 08 Jan 2015 06:20:12 GMT
Connection: close
Content-Type : application/xml
Content-Length: 236  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<Style>
  <Name>jujht9w0d4</Name>
  <Content>erp2g2twla</Content>
  <CreateTime>Thu, 08 Jan 2015 06:20:12 GMT</CreateTime>
  <LastModifyTime>Thu, 08 Jan 2015 06:20:12 GMT</LastModifyTime>
</Style>

细节分析

如果频道（Channel）不存在，返回404 Not Found错误，错误码：NoSuchChannel。
如果样式（Style）不存在，返回404 Not Found错误，错误码：NoSuchStyle。

Delete Style

Delete Style用来删除某个样式（Style）。

请求语法

DELETE /?style&styleName=YourStyleName HTTP/1.1
Host: ChannelName.img-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求参数（Request Parameters）

参数名称	说明	是否必须	取值范围
styleName	待删除的Style的名称	是	参见style命名规则

请求示例

DELETE /?style&styleName=style-example HTTP/1.1
Host: channel-example.img-cn-hangzhou.aliyuncs.com
Date: Thu, 08 Jan 2015 06:30:20 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 204 No Content
x-img-request-id: 54AE23FC79B222C77F000028
Date: Thu, 08 Jan 2015 06:30:20 GMT
Connection: close
Content-Length: 0  
Server: AliyunOSS

细节分析

如果频道（Channel）不存在，返回404 Not Found错误，错误码：NoSuchChannel。
不管样式（Style）存不存在，只要删除操作合法，删除成功后都会返回204 No Content。
只有频道（Channel）的拥有者才能删除该频道下的样式（Style）。如果试图删除一个不属于自己的频道下的样式，返回403 Forbidden错误，错误码：AccessDenied。