在本文中，我们详细介绍一下VectorDB HTTP API的错误码定义及其说明。

VectorDB HTTP API错误描述信息由前缀和后缀两部分组成，前缀部分是通用描述，后缀部分用来传达更加精准的错误信息。当然，并非每个错误描述信息都会包含后缀部分。具体的错误码及其说明介绍如下：

通用错误

错误码	错误描述信息（前缀）	详细说明
0	"Success"	成功
1	"Database Internal Error"	数据库内部错误。 一般应用于不适合对外暴露的错误场景，如遇到此类错误，请发工单联系VectorDB团队。
2	"Invalid Parameter"	无效的参数。 遇到此类错误，请参考API返回的完整错误再次检查请求输入参数是否存在不合法或者不合理的情况。

HTTP协议错误

错误码	错误描述信息（前缀）	详细说明
10	"Invalid Http URL"	无效或不完整的HTTP URL。
11	"Invalid Http Header"	无效或不完整的HTTP Header。
12	"Invalid Http Body"	无效或不完整的HTTP Body。
13	"Missing SSL Certificates"	缺失SSL证书。当启用HTTPS时才可能收到该错误。

认证与RBAC错误

错误码	错误描述信息（前缀）	详细说明
20	"User Not Found"	用户不存在。
21	"User Already Exists"	用户已存在。
22	"Role Not Found"	角色不存在。
23	"Role Already Exists"	角色已存在。
24	"Authentication Failed"	认证失败。一般是用户名与APIKey不匹配。
25	"Permission Denied"	没有权限。

库相关错误

错误码	错误描述信息（前缀）	详细说明
50	"Database Not Found"	库不存在。
51	"Database Already Exists"	库已存在。
52	"Database Too Many Tables"	库包含的表数量超限。
53	"Database Not Empty"	库非空。 在删除一个库之前，VectorDB要求必须已先将所有的表都删除，不支持直接递归删除一个非空库。

表相关错误

错误码	错误描述信息（前缀）	详细说明
60	"Invalid Table Schema"	无效的表Schema。 当建表收到此错误时，请根据API返回的完整错误提示再次检查表的Schema是否符合要求。
61	"Invalid Partition Parameters"	无效的分区参数。 当建表收到此错误时，请根据API返回的完整错误提示再次检查表的分区参数是否符合要求。
62	"Table Too Many Fields"	表包含的字段数量超限。
63	"Table Too Many Families"	表包含的列族数量超限。
64	"Table Too Many Primary Keys"	表的主键包含的字段数量超限。
65	"Table Too Many Partition Keys"	表的分区键包含的字段数量超限。
66	"Table Too Many Vector Fields"	表包含的向量字段数量超限。
67	"Table Too Many Indexes"	表包含的索引数量超限。
68	"Dynamic Schema Error"	动态字段特性处理出错。
69	"Table Not Found"	表不存在。
70	"Table Already Exists"	表已存在。
71	"Invalid Table State"	表处于不适合的状态（不适合当前操作）。
72	"Table Not Ready"	表尚未完成准备。
73	"Alias Not Found"	别名不存在。
74	"Alias Already Exists"	别名已存在。

字段相关错误

错误码	错误描述信息（前缀）	详细说明
80	"Field Not Found"	字段不存在。
81	"Field Already Exists"	字段已存在。
82	"Vector Field Not Found"	向量字段不存在。

索引相关错误

错误码	错误描述信息（前缀）	详细说明
90	"Invalid Index Schema"	无效或不合法的索引Schema。
91	"Index Not Found"	索引（名字）不存在。
92	"Index Already Exists"	索引（名字）已存在。
93	"Index Duplicated"	重复的索引。索引重复是指在一个字段建立了多个索引。
94	"Invalid Index State"	索引处于不合适的状态（不适合当前操作）。

行错误

错误码	错误描述信息（前缀）	详细说明
100	"Primary Key Duplicated"	主键重复。当插入（Insert语义）一条记录时，如果主键已存在，则报告该错误。
101	"Row Key Not Found"	指定记录主键不存在。当更新（Update语义）一条记录时，如果主键不存在，则报告该错误。