上云无忧 > 文档中心 > 百度智能云共享版消息服务 for Kafka API文档 - 错误返回
消息服务 for Kafka
百度智能云共享版消息服务 for Kafka API文档 - 错误返回

文档简介:
错误返回格式: 当用户访问API出现错误时,会返回给用户相应的错误码和错误信息,便于定位问题,并做出适当的处理。请求发生错误时通过Response Body返回详细错误信息,遵循如下格式:
*此产品及展示信息均由百度智能云官方提供。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

错误返回格式

当用户访问API出现错误时,会返回给用户相应的错误码和错误信息,便于定位问题,并做出适当的处理。请求发生错误时通过Response Body返回详细错误信息,遵循如下格式:

参数名 类型 说明
code String 表示具体错误类型
message String 有关该错误的详细说明
requestId String 本次请求的requestId

统一为如下格式(后续各接口不再单独列出):

{
    "requestId": "47e0ef1a-9bf2-11e1-9279-0100e8cf109a",
    "code":"NoSuchKey",
    "message":"The resource you requested does not exist"
}

其中,“code”为错误码,所有错误码取值来源BCE公共错误码和Kafka专有错误码(参考错误码部分内容)。

公共错误码

下表列出了百度智能云API的公共错误码。

错误码 错误消息 HTTP状态码 描述
AccessDenied Access denied. 403Forbidden 无权限访问对应的资源。
InappropriateJSON The JSON you provided was well-formed and valid, but not appropriate forthis 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 doesnot exist in our records. 403Forbidden Access Key ID不存在。
InvalidHTTPAuthHeader The Access Key ID you provided does notexist in our records. 400 BadRequest 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 BadRequest JSON格式不合法。
InvalidVersion The API version specified was invalid. 404 NotFound URI的版本号不合法。
OptInRequired A subscription for the service is required. 403Forbidden 没有开通对应的服务。
PreconditionFailed The specified If-Match header doesn’tmatch the ETag header. 412PreconditionFailed 详见Etag。
RequestExpired Request has expired. Timestamp date is <Data>. 400 BadRequest 请求超时。要改成x-bce-date。若请求中只有Date,需将Date转成datetime。
IdempotentParameterMismatch The request uses the same client token asa previous, but non-identical request. 403Forbidden clientToken对应的API参数不一样。
SignatureDoesNotMatch The request signature we calculated does not match the signature you provided. Check yourSecret Access Key and signing method. Consultthe service documentation for details. 400 Bad Request Authorization头域中附带的签名和服务端验证不一致。
相似文档
  • Topic相关接口: 创建Topic: 描述: 本接口用于创建一个Kafka topic。 请求: 请求结构: POST /v{version}/topic?clientToken={clientToken} HTTP/1.1 { "topicName": "topicName", "partitionCount": partitionCount, }
  • TopicCreateParameters: topicName String topic名称,只能包含大小写英文字母,数字,下划线_,横行-,不能使用双下划线__。 partitionCount int topic分区数,最少1个,最多10个。
  • 配置类问题: 百度消息服务支持的哪一版的Kafka? 什么是主题(TOPIC)?必须要创建吗? 什么是分区(PARTITION)? 什么是客户端? 安全类问题: 百度消息服务如何保证安全性?支持哪些安全特性? 百度消息服务如何保障数据可靠性?
  • Q:百度消息服务支持的哪一版的Kafka? A:Kafka是一个演化中的系统,客户端请选择0.10.1.1版本。 Q:什么是主题(TOPIC)?必须要创建吗? A:您需要先创建主题然后才能读写。主题是全局唯一的。
  • Q:百度消息服务如何保证安全性?支持哪些安全特性? A:百度消息服务通过如下安全特性确保安全性: 客户鉴权:由于用户可以从互联网连接消息中心,需要对用户进行鉴权以获取相应的身份方便对主题进行读写。目前支持X509证书获取身份。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部