在线图片处理
更新时间 2026-04-10 17:01:42
最近更新时间: 2026-04-10 17:01:42
功能说明
在线图片处理为GetObject请求的扩展，用于对存储桶中的图片文件在线处理，并将处理结果返回。支持处理图片格式JPG、PNG、WEBP、TIFF、GIF。
请求消息样式
GET /{Bucket}/{Key}?x-zos-process=image/[action,parame_value]/[action,parame_value] HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Date: Date
Content-Length: ContentLength
X-Amz-Content-SHA256: Content-SHA256
Authorization: Auth String请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 目标Bucket的名称。 | String | 是 |
| Key | 参数解释： 目标Key的名称。 | String | 是 |
| x-zos-process | 参数解释： 图片处理操作参数，image/[action,parame_value]/[action,parame_value]。具体请求参数及限制请参考图片处理指南。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
accept-ranges: AcceptRanges
Last-Modified: LastModified
Content-Length: ContentLength
Content-Type: ContentType
ETag: ETag
Content-Dispostion: attachment
Date: Date
Connection: Keep-Alive
x-amz-request-id: Request Id
Last-Modified: LastModified
Content-Length: ContentLength
ETag: ETag
x-amz-version-id: VersionId
x-amz-metadata-*: Metadata
Body响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。除公共响应消息头之外，还可能返回如下的消息头：
| 名称 | 描述 | 类型 |
|---|---|---|
| Content-Length | 参数解释： Body的长度。 | Long |
| ETag | 参数解释： 对象的Etag。 | String |
| x-amz-version-id | 参数解释： 对象的VersionId。 | String |
| x-amz-metadata-[自定义后缀] | 参数解释： 用户指定的元数据信息。 | String |
响应消息元素
该响应中将在线处理后的图片以消息元素的形式返回，元素的具体含义如下表所示：
| 名称 | 描述 | 类型 |
|---|---|---|
| Body | 参数解释： 返回处理后的图片，action为缩放、裁剪等具体操作时，Body返回修改后的图片数据，action为info等获取图片信息时，Body返回json数据。 | StreamingBody |
错误码
请参见调用前必知-错误码-全局错误码。
