全部产品
Search

搜索本产品

    云原生数据库 PolarDB：CreateDBInstance - 创建实例

    文档中心

    云原生数据库 PolarDB：CreateDBInstance - 创建实例

    更新时间：Sep 10, 2026

    创建PolarDB-X实例。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用前面加 * 表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    polardbx:CreateDBInstancecreate
    *全部资源
    *
      无
    		无

    请求参数

    名称类型必填描述示例值
    RegionIdstring是

    实例所在地域。

    		cn-hangzhou
    PayTypestring是

    实例付费类型。

    • PREPAY：包年包月
    • POSTPAY：按量付费
    		PREPAY
    DBNodeCountinteger否

    实例节点数量:

    • 标准版：1
    • 企业版：>=2
    		3
    DBNodeClassstring否

    创建标准时需要传, 企业版无需传。

    标准版本地盘规格：

    • mysql.n8.small.25: 1 核 8 GB（通用）
    • mysql.n2.medium.25: 2 核 4 GB（通用）
    • mysql.n4.medium.25: 2 核 8 GB（通用）
    • mysql.n8.medium.25: 2 核 16 GB（通用）
    • mysql.n2.large.25: 4 核 8 GB（通用）
    • mysql.n4.large.25: 4 核 16 GB（通用）
    • mysql.n8.large.25: 4 核 32 GB（通用）
    • mysql.n2.xlarge.25: 8 核 16 GB（通用）
    • mysql.n4.xlarge.25: 8 核 32 GB（通用）
    • mysql.n8.xlarge.25: 8 核 64 GB（通用）
    • mysql.n2.2xlarge.25: 16 核 32 GB（通用）
    • mysql.n4.2xlarge.25: 16 核 64 GB（通用）
    • mysql.n8.2xlarge.25: 16 核 128 GB（通用）
    • mysql.x2.medium.25: 2 核 4 GB（独享）
    • mysql.x4.medium.25: 2 核 8 GB（独享）
    • mysql.x8.medium.25: 2 核 16 GB（独享）
    • mysql.x2.large.25: 4 核 8 GB（独享）
    • mysql.x4.large.25: 4 核 16 GB（独享）
    • mysql.x8.large.25: 4 核 32 GB（独享）
    • mysql.x2.xlarge.25: 8 核 16 GB（独享）
    • mysql.x4.xlarge.25: 8 核 32 GB（独享）
    • mysql.x8.xlarge.25: 8 核 64 GB（独享）
    • mysql.x2.2xlarge.25: 16 核 32 GB（独享）
    • mysql.x4.2xlarge.25: 16 核 64 GB（独享）
    • mysql.x8.2xlarge.25: 16 核 128 GB（独享）
    • mysql.x4.4xlarge.25: 32 核 128 GB（独享）
    • mysql.x8.4xlarge.25: 32 核 256 GB（独享）
    • mysql.x4.8xlarge.25: 64 核 256 GB（独享）
    • mysql.x8.8xlarge.25: 64 核 512 GB（独享）
    • mysql.st.12xlarge.25: 90 核 720 GB（独享）

    标准版云盘规格：

    • polarx.mysql.n2.medium.c25: 2 核 4G(通用)
    • polarx.mysql.n4.medium.c25: 2 核 8G(通用)
    • polarx.mysql.n8.medium.c25: 2 核 16G(通用)
    • polarx.mysql.n2.large.c25: 4 核 8G(通用)
    • polarx.mysql.n4.large.c25: 4 核 16G(通用)
    • polarx.mysql.n8.large.c25: 4 核 32G(通用)
    • polarx.mysql.n2.xlarge.c25: 8 核 16G(通用)
    • polarx.mysql.n4.xlarge.c25: 8 核 32G(通用)
    • polarx.mysql.n8.xlarge.c25: 8 核 64G(通用)
    • polarx.mysql.x2.medium.c25: 2 核 4G(独享)
    • polarx.mysql.x4.medium.c25: 2 核 8G(独享)
    • polarx.mysql.x8.medium.c25: 2 核 16G(独享)
    • polarx.mysql.x2.large.c25: 4 核 8G(独享)
    • polarx.mysql.x4.large.c25: 4 核 16G(独享)
    • polarx.mysql.x8.large.c25: 4 核 32G(独享)
    • polarx.mysql.x2.xlarge.c25: 8 核 16G(独享)
    • polarx.mysql.x4.xlarge.c25: 8 核 32G(独享)
    • polarx.mysql.x8.xlarge.c25: 8 核 64G(独享)
    • polarx.mysql.x2.2xlarge.c25: 16 核 32G(独享)
    • polarx.mysql.x4.2xlarge.c25: 16 核 64G(独享)
    • polarx.mysql.x8.2xlarge.c25: 16 核 128G(独享)
    • polarx.mysql.x2.4xlarge.c25: 32 核 64G(独享)
    • polarx.mysql.x4.4xlarge.c25: 32 核 128G(独享)
    • polarx.mysql.x8.4xlarge.c25: 32 核 256G(独享)
    • polarx.mysql.x2.8xlarge.c25: 64 核 128G(独享)
    • polarx.mysql.x4.8xlarge.c25: 64 核 256G(独享)
    • polarx.mysql.x8.8xlarge.c25: 64 核 512G(独享)
    		polarx.x4.2xlarge.2d
    ClientTokenstring否

    幂等请求串，保持每次创建不同即可。

    		xxxxxx-xxx
    NetworkTypestring否

    网络类型，仅支持 VPC 网络。

    		vpc
    VPCIdstring否

    VPC ID。

    		vpc-*****
    VSwitchIdstring否

    虚拟交换机 ID。

    		vsw-*********
    UsedTimeinteger否

    预付费时，可以选择买几个月或者几年。

    说明 Period 设置为 Year 时，该参数支持的取值为 1、2、3。
    		1
    Periodstring否

    收费周期，包年包月只能选 Year、Month， 按量付费默认选择 Hour。

    		Month
    ResourceGroupIdstring否

    可以为空，资源组 ID，暂时不支持。

    		null
    AutoRenewboolean否

    是否自动续费，默认为 true。

    • true：是
    • false：否
    		true
    EngineVersionstring是

    mysql 引擎版本，5.7 或者 8.0。

    		5.7
    IsReadDBInstanceboolean否

    是否为只读实例。

    • true：是
    • false：否
    		false
    PrimaryDBInstanceNamestring否

    如果为只读实例，需要指定主实例。

    		pxc-*********
    TopologyTypestring是

    拓扑类型：

    • 3azones：三可用区；
    • 1azone：单可用区。
    		3azones
    PrimaryZonestring否

    主可用区。

    		cn-shenzhen-e
    SecondaryZonestring否

    次可用区。

    		cn-shenzhen-a
    TertiaryZonestring否

    第三可用区。

    		cn-shenzhen-e
    ZoneIdstring否

    实例可用区。

    		cn-hangzhou-a
    CnClassstring否

    计算节点规格，创建企业版需要传，创建标准版无需传。

    企业版本地盘：

    • polarx.x4.medium.2e: 2 核 8 GB（通用）
    • polarx.x4.large.2e: 4 核 16 GB（通用）
    • polarx.x4.xlarge.2e: 8 核 32 GB（通用）
    • polarx.x4.2xlarge.2e: 16 核 64 GB（通用）
    • polarx.x8.large.2e: 4 核 32 GB（独享）
    • polarx.x2.large.2x: 8 核 16 GB（独享）
    • polarx.x4.xlarge.2x: 8 核 32 GB（独享）
    • polarx.x8.xlarge.2e: 8 核 64 GB（独享）
    • polarx.x8.2xlarge.2e: 16 核 128 GB（独享）
    • polarx.x4.4xlarge.2e: 32 核 128 GB（独享）
    • polarx.x8.4xlarge.2e: 32 核 256 GB（独享）
    • polarx.st.8xlarge.2e: 60 核 470 GB（独享）
    • polarx.st.12xlarge.2e: 90 核 720 GB（独享）

    企业版云盘：

    • polarx.x4.medium.c2e: 2 核 8 GB（通用）
    • polarx.x4.large.c2e: 4 核 16 GB（通用）
    • polarx.x4.xlarge.c2e: 8 核 32 GB（通用）
    • polarx.x4.2xlarge.c2e: 16 核 64 GB（通用）
    • polarx.x8.large.c2e: 4 核 32 GB（独享）
    • polarx.x2.large.c2x: 8 核 16 GB（独享）
    • polarx.x4.xlarge.c2x: 8 核 32 GB（独享）
    • polarx.x8.xlarge.c2e: 8 核 64 GB（独享）
    • polarx.x8.2xlarge.c2e: 16 核 128 GB（独享）
    • polarx.x4.4xlarge.c2e: 32 核 128 GB（独享）
    • polarx.x8.4xlarge.c2e: 32 核 256 GB（独享）
    • polarx.st.8xlarge.c2e: 60 核 470 GB（独享）
    • polarx.st.12xlarge.c2e: 90 核 720 GB（独享）
    		polarx.x4.medium.2e
    DnClassstring否

    存储节点规格，创建企业版需要传，创建标准版无需传。

    企业版本地盘：

    • mysql.n2.medium.25: 2 核 4 GB（通用）
    • mysql.n4.medium.25: 2 核 8 GB（通用）
    • mysql.n2.large.25: 4 核 8 GB（通用）
    • mysql.n4.large.25: 4 核 16 GB（通用）
    • mysql.n4.xlarge.25: 8 核 32 GB（通用）
    • mysql.n4.2xlarge.25: 16 核 64 GB（通用）
    • mysql.x4.large.25: 4 核 16 GB（独享）
    • mysql.x8.large.25: 4 核 32 GB（独享）
    • mysql.x2.xlarge.25: 8 核 16 GB（独享）
    • mysql.x8.xlarge.25: 8 核 64 GB（独享）
    • mysql.x8.2xlarge.25: 16 核 128 GB（独享）
    • mysql.x4.4xlarge.25: 32 核 128 GB（独享）
    • mysql.x8.4xlarge.25: 32 核 256 GB（独享）
    • mysql.st.8xlarge.25: 60 核 470 GB（独享）
    • mysql.st.12xlarge.25: 90 核 720 GB（独享）
    • mysql.x8.45xlarge.25: 180 核 1440 GB（独享）
    • mysql.x8.60xlarge.25: 240 核 1920 GB（独享）

    企业版云盘：

    • polarx.mysql.n2.medium.c25: 2 核 4 GB（通用）
    • polarx.mysql.n4.medium.c25: 2 核 8 GB（通用）
    • polarx.mysql.n2.large.c25: 4 核 8 GB（通用）
    • polarx.mysql.n4.large.c25: 4 核 16 GB（通用）
    • polarx.mysql.n4.xlarge.c25: 8 核 32 GB（通用）
    • polarx.mysql.n4.2xlarge.c25: 16 核 64 GB（通用）
    • polarx.mysql.x4.large.c25: 4 核 16 GB（独享）
    • polarx.mysql.x8.large.c25: 4 核 32 GB（独享）
    • polarx.mysql.x2.xlarge.c25: 8 核 16 GB（独享）
    • polarx.mysql.x8.xlarge.c25: 8 核 64 GB（独享）
    • polarx.mysql.x8.2xlarge.c25: 16 核 128 GB（独享）
    • polarx.mysql.x4.4xlarge.c25: 32 核 128 GB（独享）
    • polarx.mysql.x8.4xlarge.c25: 32 核 256 GB（独享）
    • polarx.mysql.st.8xlarge.c25: 60 核 470 GB（独享）
    • polarx.mysql.st.12xlarge.c25: 90 核 720 GB（独享）
    • polarx.mysql.x8.45xlarge.c25: 180 核 1440 GB（独享）
    • polarx.mysql.x8.60xlarge.c25: 240 核 1920 GB（独享）
    		mysql.n4.medium.25
    CNNodeCountinteger否

    计算节点个数。

    		2
    DNNodeCountinteger否

    存储节点个数。

    		2
    IsColumnarReadDBInstanceboolean否

    创建的实例是否为列存只读实例。

    		true
    Seriesstring否

    企业版：enterprise 标准版：standard

    		enterprise
    DnStorageSpacestring否

    存储节点磁盘空间大小

    		1500
    ExtraParamsobject否

    其他参数

    string否

    其他参数

    		xxxx
    Descriptionstring否

    数据库描述。

    		ods_api_apidata_mobilegame_pay_api_di
    OriginMinorVersionstring否

    小版本号，通常不需要传

    StorageTypestring否

    存储类型

    • 本地盘：custom_local_ssd
    • 云盘：cloud_auto
    		cloud_auto

    返回参数

    名称类型描述示例值
    object
    DBInstanceNamestring

    创建的实例名称。

    		pxc-*********
    RequestIdstring

    请求 ID。

    		9B2F3840-5C98-475C-B269-2D5C3A31797C
    OrderIdstring

    订单号。

    		12345

    示例

    正常返回示例

    JSON格式

    {
  "DBInstanceName": "pxc-*********",
  "RequestId": "9B2F3840-5C98-475C-B269-2D5C3A31797C",
  "OrderId": 12345
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2026-03-04OpenAPI 入参发生变更查看变更详情
    2025-12-18OpenAPI 入参发生变更查看变更详情
    2025-03-12OpenAPI 描述信息更新查看变更详情
    2025-03-12OpenAPI 描述信息更新查看变更详情
    2025-03-12OpenAPI 描述信息更新查看变更详情
    2025-03-12OpenAPI 描述信息更新查看变更详情
    2024-12-03OpenAPI 入参发生变更查看变更详情
    2024-06-13OpenAPI 入参发生变更查看变更详情
    2024-04-24OpenAPI 入参发生变更查看变更详情
    2023-12-14OpenAPI 入参发生变更查看变更详情
    2023-09-01OpenAPI 入参发生变更查看变更详情