{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Hmwbl4swe","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttp://{host}/v{version}/database?create\n
\n
\n
\n

新建一个库，用于进一步创建各类表。

\n
\n
\n

权限说明

\n

鉴权认证机制的详细内容请参见鉴权认证

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
URL 参数
\n
\n
\n
\n
\n
\n\nversion\n\nstring\n
\n

API版本号，当前取1。

\n
\n
必选
\n
\n
\n
\n\nhost\n\nstring\n
\n

\"{实例IP}:{实例Port}\"

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
Query 参数
\n
\n
\n
\n
\n
\n\ncreate\n\nstring\n
\n

创建库操作

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\ndatabase\n\nstring\n
\n

库的名称，要求实例内部唯一。库的命名要求如下：

\n
    \n
  1. 仅支持大小写字母、数字以及下划线（_），必须以字母开头；
    2. \n
  2. 长度限制为1~255。
    3. \n
\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /v{version}/database?create HTTP/1.1\nHOST: {Endpoint}\nAuthorization: {Authorization}\n{\n    \"database\": \"db_name\"\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
请求示例
\n\n
\n
\n\n
\n
curl --location 'http://vdb.nXWNyPCOSLci.vdb.bj.baidubce.com/v1/database?create' \\\n--header 'Authorization: Bearer account=root&api_key=eC4bLRy2va******************************' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"database\": \"db_test\"\n}'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\ncode\n\ninteger\n
\n

返回码

\n
\n
可选
\n
\n
\n
\n\nmsg\n\nstring\n
\n

返回信息

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
{\n    \"code\": 0,\n    \"msg\": \"Success\"\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
","fields":{"slug":"Hmwbl4swe","title":"创建库","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Hmwbl4swe","prev":{"id":"8mwbl4suy","name":"删除库","path":"8mwbl4suy","filePath":"Agent/向量数据库/数据面/删除库.md","seo":null,"parentIds":["Mmwbl4qxa","Gmwbl4soa","Umwbl4soi"],"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Gmwbl4soa","documentId":"1874b1d0-8471-4bdd-a0f6-bef63d790cd0","name":"向量数据库","repoName":"qianfan-api","filePath":"Agent/向量数据库","disabled":false,"path":"Gmwbl4soa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Umwbl4soi","documentId":"46e45008-14d8-4534-bdce-d35677fcd313","name":"数据面","repoName":"qianfan-api","filePath":"Agent/向量数据库/数据面","disabled":false,"path":"Umwbl4soi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"xmwbl4sxs","name":"查询单条记录","path":"xmwbl4sxs","filePath":"Agent/向量数据库/数据面/查询单条记录.md","seo":null,"parentIds":["Mmwbl4qxa","Gmwbl4soa","Umwbl4soi"],"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Gmwbl4soa","documentId":"1874b1d0-8471-4bdd-a0f6-bef63d790cd0","name":"向量数据库","repoName":"qianfan-api","filePath":"Agent/向量数据库","disabled":false,"path":"Gmwbl4soa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Umwbl4soi","documentId":"46e45008-14d8-4534-bdce-d35677fcd313","name":"数据面","repoName":"qianfan-api","filePath":"Agent/向量数据库/数据面","disabled":false,"path":"Umwbl4soi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Mmwbl4qxa","documentId":"14a689a9-e16b-4e40-ba67-9e0a3a66f51e","name":"Agent","repoName":"qianfan-api","filePath":"Agent","disabled":false,"path":"Mmwbl4qxa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Gmwbl4soa","documentId":"1874b1d0-8471-4bdd-a0f6-bef63d790cd0","name":"向量数据库","repoName":"qianfan-api","filePath":"Agent/向量数据库","disabled":false,"path":"Gmwbl4soa","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Umwbl4soi","documentId":"46e45008-14d8-4534-bdce-d35677fcd313","name":"数据面","repoName":"qianfan-api","filePath":"Agent/向量数据库/数据面","disabled":false,"path":"Umwbl4soi","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}