错误格式
当 PDS 在处理请求时,若发生异常,SDK 返回值形如
{
"Message": "The input parameter file_id is not valid.",
"RequestId": "772328B2-E5F4-453C-9C23-CCCCCCCC",
"Code": "InvalidParameter"
}
且 HTTP 状态码也会相应变化。其中:
- Code 为错误码,提示错误类型。
- Message 为错误消息,提示错误的原因和解决办法。
- RequestId 为请求的唯一 ID。(注意:在使用接口调用时,此参数在 Http Header: x-ca-request-id 中)
有少量场景,网关层报错,其错误码和错误代码形式如下:
x-ca-error-code: D504TO
x-ca-error-message: timeout
x-ca-request-id: 772328B1-E5F4-453C-9C23-CCCCCCCC
其中:
- x-ca-error-code 为错误码,提示错误类型。
- x-ca-error-message 为错误消息,提示错误的原因和解决办法。
- x-ca-request-id 为请求的唯一 ID。
通用错误码表
以下列出了通用错误码表,涵盖大部分可能出现的错误。其中:
- {parameter_name}和 {resource_name}在实际返回的响应中,分别对应字段名称和资源类型。
- HTTP Status Code 列为响应的 HTTP 状态码。
- Message 列中的信息可能与实际返回的响应略有不同,这通常是为了提示更具体的错误信息。
HTTP Status Code | Code | Message |
---|---|---|
400 | InvalidParameter | The input parameter {parameter_name} is not valid. |
400 | InvalidParameterEmpty | The input parameter {parameter_name} is empty. |
400 | InvalidParameterWrongFormat | The input parameter {parameter_name} has invalid format. |
400 | InvalidRequestJSONFormat | The input parameter {parameter_name} is invalid Json format. |
400 | InvalidParameterNotSupported | The input parameter {parameter_name} is not supported |
400 | InvalidParameterMissing | The input parameter {parameter_name} is missing. |
400 | InvalidParameterNotMatch | The input parameter {parameter_name} doesn’t match. |
400 | InvalidParameterOutOfRange | The input parameter {parameter_name} doesn’t match the limitation. |
400 | InvalidParameterExpired | The input parameter {parameter_name} is expired. |
400 | QuotaExhausted | The resource {resource_name} has exceeded the limit. |
400 | InvalidResource | The resource {resource_name} is not valid. |
400 | NotEmpty | The resource {resource_name} is not empty. |
404 | InvalidResourceIsEmpty | The resource {resource_name} is empty. |
400 | InvalidResourceUnsupported | The resource {resource_name} is not supported. |
404 | NotFound | The resource {resource_name} cannot be found. |
400 | AlreadyExist | The resource {resource_name} has already exists |
403 | Forbidden | User not authorized to operate on the specified APIs. |
403 | ForbiddenNoPermission | No Permission to access resource {resource_name}. |
403 | ForbiddenAccountNotFound | The specified account does not exist. |
403 | ForbiddenAccountInDebt | The specified account is in debt. |
403 | ForbiddenServiceRole | Cannot access specified service role. |
403 | ForbiddenRiskControl | This operation is forbidden by Alibaba Cloud RiskControl system. |
403 | ForbiddenFileInTheRecycleBin | This operation is forbidden for file in the recycle bin. |
400 | StateConflict | User operation is not valid. Please try again later. |
500 | InternalError | The request has been failed due to some unknown error. Please try again later |
405 | HTTPMethodNotAllowed | The request http method is not supported for this resource. Please refer to document |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. Please try again later. |
400 | Throttling | The operation is blocked due to throttling control. |
400 | IncorrectStatus | The current status does not support this operation. |
400 | InvalidHeader | Header {header_name} is not valid. |
400 | SignatureDoesNotMatch | SignatureDoesNotMatch |
400 | DriveRelativePathNested | The input parameter relative_path nested inside of another relative_path: {path}. |
400 | Sha1Conflict | Find multiple objects of the same sha1. |
400 | ReadBodyError | Read body error. |
如有任何问题,欢迎 联系我们。