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

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

错误响应的消息体示例如下:

<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 状态码
InvalidArgument 参数错误 400
BadRequest 错误请求 400
MissingArgument 缺少参数 400
ImageTooLarge 图片大小超过限制 400
WatermarkError 水印错误 400
AccessDenied 拒绝访问 403
SignatureDoesNotMatch 签名不匹配 403
NoSuchFile 图片不存在 404
NoSuchStyle 样式不存在 404
InternalError 服务内部错误 500
NotImplemented 方法未实现 501

SDK 示例