图片服务提供了一些样式（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 2onpuorvhikxergnrzmwkn0t:Hyc0UH+CXKQv6ExbZMi+HPn4Gxc= <?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 2onpuorvhikxergnrzmwkn0t:zDI6c1trJAGHbR8rreyzq6lMq9U=
返回示例
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 2onpuorvhikxergnrzmwkn0t:SQe/ZdW92fmFgLEiIwsH4f8YTA8=
返回示例
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 2onpuorvhikxergnrzmwkn0t:mK217ZMjVP30w4Q99vYwBEgddqw=
返回示例
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。