基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
CreateDatabase - 创建数据库
更新时间：2026-06-25 13:21:57
分享
使适用性说明
当前版本不支持备集群创建数据库。
功能说明
该接口用于在指定租户下创建一个新的数据库。
调用说明
接口约束
调用者需要拥有访问多云 API 的密钥。AccessKey ID、AccessKey Secret 的获取方式，详情参见 访问密钥管理。
请求路径
POST /api/v2/instances/{instanceId}/tenants/{tenantId}/databases
请求参数
Query
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| instanceId | string | 是 | OB Cloud 云数据库实例 ID。 | ob317v4uif**** |
| tenantId | string | 是 | 租户 ID。 | ob2mr3oae0**** |
Body
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| instanceId | string | 是 | OB Cloud 云数据库实例 ID。 | ob317v4uif**** |
| tenantId | string | 是 | 租户 ID。 | ob2mr3oae0**** |
| databaseName | string | 是 | 数据库名称。 不能使用某些预留关键字，如 test、mysql。 | databasetest |
| encoding | string | 是 | 数据库编码方式。 目前支持 utf8mb4 和 gbk 编码。 | utf8mb4 |
| collation | string | 否 | 数据库排序规则。 | utf8mb4_general_ci |
| description | string | 否 | 数据库描述信息。 | this is a test database |
| requestId | string | 否 | 请求 ID，用于幂等性控制。 | req-20231012094530-001 |
返回结果
| 名称 | 类型 | 描述 |
|---|---|---|
| data | object | 数据库信息。 |
| success | boolean | 请求是否成功。 |
示例
请求示例
curl -v --request POST \
--digest -u '<您的 ak:sk>' \
--url 'https://api-cloud-cn.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/databases' \
-H 'Content-Type: application/json' \
-H 'X-Ob-Project-Id: <项目 ID>' \
--data '{"instanceId":"ob4ioyiw82yhuo","tenantId":"t4ismze9nltds","databaseName":"databasetest","encoding":"utf8mb4","collation":"utf8mb4_general_ci","description":"this is a test database","requestId":"req-20231012094530-001"}'
说明
- 项目 ID 是项目的唯一标识，您可以参考 项目管理 获取集群的项目 ID。
- 请确保 instanceId 所属项目的 ID 和指定项目 ID 一致。
返回示例
JSON 格式
{
"data": {},
"success": true
}
