---
title: "CreateDatabase - 创建数据库 - OB Cloud 云数据库 master | OceanBase 文档中心"
description: CreateDatabase - 创建数据库 使适用性说明 当前版本不支持备集群创建数据库。 功能说明 该接口用于在指定租户下创建一个新的数据库。 调用说明 接口约束 调用者需要拥有访问多云 API 的密钥。AccessKey ID、AccessKey Secret 的获取方式，详情参见 访问密钥管理 。 请求路径 …
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库

# CreateDatabase - 创建数据库

更新时间：2026-06-25 13:21:57

#### 使适用性说明

当前版本不支持备集群创建数据库。

## 功能说明

该接口用于在指定租户下创建一个新的数据库。

## 调用说明

### 接口约束

调用者需要拥有访问多云 API 的密钥。AccessKey ID、AccessKey Secret 的获取方式，详情参见 [访问密钥管理](https://www.oceanbase.com/docs/common-oceanbase-cloud-0000000002295194)。

### 请求路径

`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 | 请求是否成功。 |

## 示例

### 请求示例

```bash
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 是项目的唯一标识，您可以参考 [项目管理](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000000703404) 获取集群的项目 ID。
 - 请确保 instanceId 所属项目的 ID 和指定项目 ID 一致。

### 返回示例

`JSON` 格式

```json
{
  "data": {},
  "success": true
}

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线