当请求成功时,返回 code = 0
,示例如下:
{"code":0,"message":"success","request_id":"02173901722303500000000000000000000ffff0a004c5f712d93"}
当请求失败时,将返回相应的错误码。例如,code = 1000005
表示 collection
不存在,示例如下:
{"code":1000005,"message":"collection does not exist","request_id":"02173901687058500000000000000000000ffff0a004c5f532dbf"}
在 SDK 中,请求失败时会抛出异常。异常的返回内容与 API 返回格式相同,可进行异常捕获处理,并根据 code
值进行具体问题排查。
错误码 | 含义 | 触发条件 | 处理建议 |
---|---|---|---|
0 | 请求成功 | ||
1000001 | 用户鉴权失败 | 例如 **** AK/SK 设置不正确、未对请求体签名或子账户权限不足 |
https://www.volcengine.com/docs/84313/1254467
https://www.volcengine.com/docs/84313/1254529
https://www.volcengine.com/docs/84313/1254488
|
1000003 | 请求参数不合法 | 输入请求参数格式不正确或错误使用 |
|
1000004 | 创建 collection 已存在 | 重复创建同名 collection | 检查 collection 是否存在 |
1000005 | 请求的 collection 不存在 | collection 名字写错或不存在 | 检查 collection 是否存在 |
1000007 | 创建的index已存在 | 同一个collection下创建 index 名称重复 | 检查index 是否存在 |
1000008 | 请求的index 不存在 | index 名字写错或不存在 | 检查index 是否存在 |
1000011 | collection 数据不存在 | update_data 一条不存在的数据 | 检查数据是否存在 |
1000013 | collection 删除数据失败 | 删除数据失败,一般是服务端出现问题 | 及时联系客服反馈 |
1000014 | collection 写入数据失败 | 写入数据失败,一般是服务端出现问题 | 及时联系客服反馈 |
1000016 | 检索输入的向量不合法 | 向量输入不正确,维度不一致或格式不正确 | 检查检索请求的向量字段 |
1000017 | 输入的主键不合法 | 主键类型不匹配或格式不正确 | 检查主键字段 |
1000019 | 检索输入的标量过滤语句有问题 | 输入的格式不正确,字段未加入到scalar index中,字段过滤语句使用不当 | |
1000021 | Index 检索出现问题 | 服务端出现未知错误或发生故障 | 及时联系客服反馈 |
1000022 | Index 获取数据出现问题 | 服务端出现未知错误或发生故障 | 及时联系客服反馈 |
1000023 | Index 初始化中 | Index 初始化时就对 index 进行检索或查询数据 | 等待 Index 已就绪,若长时间(超过1小时)依旧没有就绪,请及时联系客服反馈 |
1000025 | 执行Embedding 发生异常 | 服务端对非结构化数据做向量化时报错,出现未知错误或发生故障 | 若偶现报错请检查输入数据的格式是否合法 |
1000028 | 服务端内部错误 | 服务端出现不符合预期的报错 | 及时联系客服反馈 |
1000029 | 请求触发限流 | 某个接口请求 qps 太高 | 若检索请求出现限流,请增加 CPU Quota,若有疑问可联系客服 |
1000031 | Collection 别名不存在 | Collection 别名写错或不存在 | 检查 Collection 别名 |
1000032 | 用户未下单 | 用户没有在对应区域(如华北)下单就请求该区域的向量库服务 | 到火山官网下单购买向量库服务,或到向量库界面下单 |
1000033 | 用户欠费逾期 | 用户欠费逾期 | 请充值 |
1000035 | 离线任务不存在 | 没有找到 task_id 对应的离线任务 | 检查离线任务是否存在 |