---
description: 命名空间和模块：tencent.cloud.serverless.database.client
---

# create\_instance 方法

## 简要

创建一个新的无服务器数据库实例。

```python
def create_instance(self,
    region_id: str,
    zone_id: str,
    instance_name: str,
    instance_configure: dict = None
) -> dict
```

## 参数

该方法具有以下参数，其参数名、参数类型和参数描述如下：

| 参数                  | 类型                                                                                                                              | 必选 | 描述                                                        |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -- | --------------------------------------------------------- |
| region\_id          | str                                                                                                                             | 是  | <p>创建的无服务器数据库实例目的数据中心园区唯一标识符。</p><p>例如：ap-shanghai</p>    |
| zone\_id            | str                                                                                                                             | 是  | <p>创建的无服务器数据库实例目的数据中心可用区唯一标识符。</p><p>例如：ap-shanghai-2</p> |
| instance\_name      | str                                                                                                                             | 是  | <p>创建的无服务器数据库实例名称。</p><p>例如：default</p>                   |
| instance\_configure | [InstanceConfigure](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-database/data-types/instance-configure) | 否  | 创建的无服务器数据库实例配置。                                           |

## 返回值

该方法返回包含创建的无服务器数据库实例元数据信息的字典实例，其数据类型为 [InstanceInfo](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-database/data-types/instance-info)。

{% hint style="info" %}
请注意，受限于 Tencent Cloud API，该方法目前仅支持返回实例 ID。
{% endhint %}

## 异常

该方法可能会主动引发以下异常类型：

#### ValueError

参数值或类型不符合预期。

## 示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

```python
instance_info: dict = client.create_instance(
    region_id = 'ap-shanghai',
    zone_id = 'ap-shanghai-2',
    instance_name = 'unit-test',
    instance_configure = {
        'database': {
            'version': '10.4',
            'charset': database.DatabaseCharset.UTF8
        },
        'vpc': {
            'id': 'vpc-f7qfb64q',
            'subnet_id': 'subnet-aieh8myj'
        }
    }
)

# 请注意，目前字典 instance_info 仅包含成员 'id'。

print(instance_info['id'])
```

## 适用于

#### Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-serverless-database >= 0.1.1
