错误响应

当您访问图片处理服务出现错误时,图片处理服务会将相应的错误码和错误信息返回给您,以帮助您定位与处理问题。

图片处理服务错误的响应格式

错误响应的消息体例子:

<Error>
  <Code>BadRequest</Code>
  <Message>Input is not base64 decoding.</Message>
  <RequestId>52B155D2D8BD99A15D0005FF</RequestId>
  <HostId>userdomain</HostId>
</Error>

错误包含以下元素:

  • Code:图片处理服务返回给用户的错误码。

  • Message:图片处理服务给出的详细错误信息。

  • RequestId:用以标识错误请求的唯一UUID。在无法解决问题时候,可以使用此错误ID发送给图片处理服务的工程师去定位错误的原因。

  • HostId:用来标识访问的图片处理服务集群。

图片处理服务的错误码

错误码

描述

HTTP 状态码

TooManyPipe

管道数目超过限制

400

InvalidArgument

参数错误

400

BadRequest

错误请求

400

MissingArgument

缺少参数

400

ImageTooLarge

图片大小超过限制

400

WatermarkError

水印错误

400

AccessDenied

拒绝访问

403

SignatureDoesNotMatch

签名不匹配

403

NoSuchFile

图片不存在

404

NoSuchStyle

样式不存在

404

NoSuchChannel

频道不存在

404

InternalError

服务内部错误

500

NotImplemented

方法未实现

501

处理参数限制说明

目前图片处理有如下默认限制:

  • 待处理的原图片的大小限制在20 MB以内。

  • 缩略操作:对缩略后的图片的大小有限制,目标缩略图的宽与高的乘积不能超过4096 * 4096, 而且单边的长度不能超过4096。

  • 旋转操作:旋转对图片的尺寸有限制,图片的宽或者高不能超过4096。

  • 管道目前限制在4个。