功能描述
该接口用于对某一个存储桶设置样式功能,设置样式后,可以方便地对图片进行统一的处理。
授权说明
服务开通
使用该功能将默认为您开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。
使用限制
使用该接口时,请先确认相关限制条件。详情请参见 使用限制。
Bucket 接口目前频控存在限制要求,写请求最多1qps,读请求最多10qps。
费用说明
该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 图片处理费用。
如果采用下载时处理的方式,且通过外网进行下载,调用会产生 流量费用。
请求
请求示例
PUT /?style HTTP/1.1Host: <BucketName-APPID>.pic.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String<XML File>
说明:
请求头
请求体
<?xml version="1.0" encoding="UTF-8" ?><AddStyle><StyleName>string</StyleName><StyleBody>string</StyleBody></AddStyle>
具体节点描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
AddStyle | 无 | 待添加的样式信息 | Container | 是 |
Container 节点 AddStyle 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
StyleName | AddStyle | 样式名称 | string | 是 |
StyleBody | AddStyle | 样式详情 | string | 是 |
响应
响应头
响应体
该响应体返回为空。
错误码
实际案例
请求
PUT /?style HTTP/1.1Host: examplebucket-1250000000.pic.ap-chengdu.myqcloud.comDate: Tue, 03 Apr 2019 09:06:15 GMTAuthorization:XXXXXXXXXXXX<?xml version="1.0" encoding="UTF-8" ?><AddStyle><StyleName>style_name</StyleName><StyleBody>imageMogr2/thumbnail/!50px</StyleBody></AddStyle>
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 0Date: Tue, 03 Apr 2019 09:06:16 GMTx-cos-request-id: xxxxxxxxxxxxxxxxxx