创建数据库-CreateUDBInstance

创建UDB实例(包括创建mysql master节点、mongodb primary/configsvr节点和从备份恢复实例)

Request Parameters

Parameter nameTypeDescriptionRequired
Regionstring地域。 参见 地域和可用区列表Yes
Zonestring可用区。参见 可用区列表Yes
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口No
Namestring实例名称,至少6位Yes
AdminPasswordstring管理员密码Yes
DBTypeIdstringDB类型id,mysql/mongodb/postgesql按版本细分 1:mysql-5.1,2:mysql-5.5,3:percona-5.5,4:mysql-5.6,5:percona-5.6,6:mysql-5.7,7:percona-5.7,8:mariadb-10.0,9:mongodb-2.4,10:mongodb-2.6,11:mongodb-3.0,12:mongodb-3.2,13:postgresql-9.4,14:postgresql-9.6,14:postgresql-10.4Yes
Portint端口号,mysql默认3306,mongodb默认27017,postgresql默认5432Yes
DiskSpaceint磁盘空间(GB), 暂时支持20G - 3000GYes
ParamGroupIdintDB实例使用的配置参数组idYes
MemoryLimitint内存限制(MB),目前支持以下几档 1000M/2000M/4000M/ 6000M/8000M/12000M/16000M/ 24000M/32000M/48000M/ 64000M/96000MYes
ChargeTypestringYear, Month, Dynamic,Trial,默认: MonthNo
Quantityint购买时长,默认值1No
AdminUserstring管理员帐户名,默认rootNo
BackupCountint备份策略,每周备份数量,默认7次No
BackupTimeint备份策略,备份开始时间,单位小时计,默认1点No
BackupDurationint备份策略,备份时间间隔,单位小时计,默认24小时No
BackupIdint备份id,如果指定,则表明从备份恢复实例No
UseSSDbool是否使用SSD,默认为false。目前主要可用区、海外机房、新机房只提供SSD资源,非SSD资源不再提供。No
SSDTypestringSSD类型,可选值为"SATA"、"PCI-E",如果UseSSD为true ,则必选No
InstanceModestringUDB实例模式类型, 可选值如下: "Normal": 普通版UDB实例 "HA": 高可用版UDB实例 默认是"Normal"No
UDBCIdstring专区ID信息(如果这个参数存在这说明是在专区中创建DB)No
CPUintcpu核数No
InstanceTypestringUDB数据库机型No
BackupZonestring跨可用区高可用备库所在可用区,参见 可用区列表No
SubnetIdstring子网IDNo
VPCIdstringVPC的IDNo
DisableSemisyncbool是否开启异步高可用,默认不填,可置为trueNo
ClusterRolestring当DB类型(DBTypeId)为mongodb时,需要指定mongo的角色,可选值为configsrv (配置节点),shardsrv (数据节点)No
HAArchstring高可用架构:1) haproxy(默认): 当前仅支持mysql。2) sentinel: 基于vip和哨兵节点的架构,当前支持mysql和pg。No
Tagstring实例所在的业务组名称No
CouponIdstring使用的代金券idNo
创建跨可用区的高可用注意项:
1. 需要参数 BackupZone:值为高可用容灾的ZoneId
2. 参数ParamGroupId: 值为跨可用区的配置文件,可以通过DescribeUDBParamGroup获得

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
DBIdstringBD实例idNo

Request Example

https://api.ucloud.cn/?Action=CreateUDBInstance
&Region=cn-bj2
&Zone=cn-bj2-04
&DBTypeId=mysql-5.6
&ChargeType=Month   
&Name=my_test_udb
&AdminUser=root
&AdminPassword=mysql_12
&Port=3306
&ParamGroupId=10
&MemoryLimit=1500
&DiskSpace=200
&InstanceMode=HA
&ClusterRole=IcPiHioG
&HAArch=haproxy
&Tag=awpGFPaP

Response Example

{
    "Action": "CreateUDBInstanceResponse",
    "DBId": "udbha-xxxxxx",
    "RetCode": 0
}