错误返回

错误返回格式

通用错误返回格式如下:

{
     "requestId": "<bce-request-id>",
     "code":"<error-code>",
     "message":"<error-message>",
     "success":false
 }

“查询可播放文件的实际路径”接口的错误返回格式与通用错误返回格式不同,具体如下:

{
    "requestId":"<bce-request-id>",
    "code":"<error-code>",
    "message":{"global":"<error-message>"},
    "success":false
}

通用错误返回码

错误返回码 错误消息 状态码 说明
AccessDenied Access denied. 403 Forbidden 无权限访问对应的资源。
InappropriateJSON

The JSON you provided was well-formed

and valid, but not appropriate for this operation.

400 Bad

Request

请求中的JSON格式正确,但语义上不符合 要求。如缺少某个必需项,或值类型不匹配 等。出于兼容性考虑,对于所有无法识别 的项应直接忽略,不应该返回这个错误。
InternalError

We encountered an internal error.

Please try again.

500 Internal

Server Error

所有未定义的其他错误。在有明确对应的 其他类型的错误时(包括通用的和服务自 定义的)不应该使用。
InvalidAccessKeyId The Access Key ID you provided does not exist in our records. 403 Forbidden Access Key ID不存在。
InvalidHTTPAuthHeader The Access Key ID you provided does not exist in our records. 400 Bad Request Authorization头域格式错误。
InvalidHTTPRequest

There was an error in the body of your

HTTP request.

400 Bad

Request

HTTP body格式错误。例如不符合指定的 Encoding等。
InvalidURI Could not parse the specified URI.

400 Bad

Request

URI形式不正确。例如一些服务定义的关键 词不匹配等。对于ID不匹配的问题,应定义 更加具体的错误码,如NoSuchKey。
MalformedJSON The JSON you provided was not well-formed. 400 Bad Request JSON格式不合法。
InvalidVersion The API version specified was invalid. 404 Not Found URI的版本号不合法。
OptInRequired A subscription for the service is required. 403 Forbidden 没有开通对应的服务。
PreconditionFailed The specified If-Match header doesn’t match the ETag header. 412 Precondition Failed 详见Etag。
RequestExpired Request has expired. Timestamp date is <Data> . 400 Bad Request 请求超时。<Data>要改成x-bce-date。若 请求中只有Date,需将Date转成datetime。
IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. 403 Forbidden clientToken对应的API参数不一样。
SignatureDoesNotMatch

The request signature we calculated does not

match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details.

400 Bad

Request

Authorization头域中附带的签名和服务端 验证不一致。

VOD错误返回码

错误返回码 错误消息 描述 HTTP状态码
NoSuchMedia The requested media does not exist. Please double confirm your mediaId or the existence of the media. 所访问的媒资不存在,请重新确定指定的mediaId 是否正确或确认指定media是否存在。 404
MediaNotPublish The requested media does not published. double confirm you have published the media. 所访问的media状态不是"已发布"。 404
AccessDenied You have no access to the media. Please check your code. 资源未被授权。 403
InvalidParameter There are field(s) invalid in the request message body, please check your code. 请求的结构体包含一个或多个字段错误。 400
StorageExceedLimit Your storage exceeds limit. 存储容量超过最大限制。 400
BandwidthExceedLimit Your bandwidth exceeds limit. 流量已超过最大限制。 400