當使用者訪問圖片處理服務出現錯誤的時候,圖片處理服務會返回給使用者相應的錯誤碼和錯誤資訊,以幫助使用者定位與處理問題。
圖片處理服務錯誤的響應格式
錯誤響應的消息體例子:
<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 |
處理參數限制說明
目前圖片處理有如下預設限制:
- 處理源檔案的大小限制在20MB。
- 縮略操作:對縮略後的圖片的大小有限制,目標縮圖的寬與高的乘積不能超過 4096 * 4096, 而且單邊的長度不能超過 4096 * 4。
- 旋轉操作:旋轉對圖的尺寸有限制,圖片的寬或者高不能超過4096。
- 管道目前限制在4個。