文档中心 > CreateDBInstance
CreateDBInstance

最近更新时间:2022-01-20

请求路径:/api/rds

请求方法:POST

接口描述:创建RDS实例

请求参数

名称

类型

是否必选

示例值

描述

Action

String

CreateDBInstance

系统规定参数。取值:CreateDBInstance

请求消息体

名称

类型

是否必选

示例值

描述

Engine

String

mysql

数据库类型。取值:mysql

RegionId

String

cn-beijing

地域ID

Port

Integer

3306

数据库服务端口,目前采用默认端口,不支持修改。mysql默认端口:3306

EngineVersion

String

5.7

数据库版本,目前mysql只支持5.7版本

AzId

String

cb-bejing-a

主节点可用区ID,目前只支持单可用区,根据RegionId上送对应的可用区ID。高可用版还需要上送AzIdSlave

InstanceMode

String

SE

数据库系列。取值:-SE:单机版 -HA:高可用版

InstanceType

String

normal

实例类型。取值:-normal:常规实例 -read_only:只读实例

VpcId

String

vpc-wrxxxxxxxx

VPC ID

VpcSubnetId

String

619a6d2a3fxxxxxxxxxxxxxxx

子网ID

InstanceClass

String

db.s1.large

实例规格码

InstanceStorage

Integer

10

实例存储空间,单位:GB。取值:10~2048

InstanceStorageType

String

local

存储类型,目前只支持local

PayType

String

YEAR_MONTH

计费方式。取值:

  • YEAR_MONTH(包年包月)

  • CHARGING_HOURS(按小时计费)

Quantity

Integer

1

购买实例个数,取值:1~5

AzIdSlave

String

cb-bejing-a

备节点可用区ID,高可用版实例必选

SourceInstanceId

String

mysql-lv1xxxxxxx

源实例ID,当InstanceType为read_only时必选

UsedTime

Integer

6

购买时长,单位:月。PayType为YEAR_MONTH必选。取值:1,2,3,6,12

Period

String

month

购买时长单位。PayType为YEAR_MONTH必选。目前只支持month

RenewType

String

manualrenew

续费类型,PayType为YEAR_MONTH必选。取值:

  • autorenew:自动续费 

  • manualrenew:手动续费(到期提醒) 

  • notrenew:到期不续费(无到期提醒)

ProjectId

String

projecttest1

项目ID,企业用户需要填写,非企用户会使用默认项目值

返回参数

状态码:202

名称

类型

示例值

描述

DBInstanceId

String

mysql-lv1xxxxxxx

实例ID,多个实例ID逗号分隔。

OrderId

String

11491951915554xxxxxxx

订单ID。

RequestId

String

rm-uf6wjk5xxxxxxxxxx

请求ID。

示例

请求示例

POST https://api.unicloud.com/api/rds?

Action=CreateDBInstance

body
{
"Port":3306,
"EngineVersion":"5.7",
"AzId":"cn-tianjin-yfb1",
"AzIdSlave":"",
   "PayType": "YEAR_MONTH",
   "Quantity": 1,
   "RenewType": "manualrenew",
   "UsedTime": 1,
   "Period":"month",
   "InstanceStorage": 10,
   "InstanceStorageType": "local",
   "SourceInstanceId": "",
   "InstanceType": "normal",
   "InstanceMode": "SE",
   "VpcId": "vpc-zi8h5oxxxxxxx",
   "VpcSubnetId": "af308f6a8bd04d258dfxxxxxxxxxxx",
   "InstanceClass":"db.c1.medium",
   "Engine":"mysql",
   "RegionId":"cn-tianjin-yfb"
}

返回示例

{
   "RequestId": "b9de1a62-d09e-4d34-9a61-38f0f56564b6",
   "DBInstanceId": "mysql-xxxxxxxxx",
   "OrderId": "868868781xxxxxxxx"
}