创建实例

最近更新时间:2021-10-14 10:42:11

查看PDF

CreateDBInstance 创建实例

创建MySQL实例(高可用实例或单实例)。
目前仅支持在VPC机房创建实例,所以用户在创建时需指定vpc网络信息,如果需要在basic机房创建实例可联系售后处理。
新建实例时,实例引擎、版本号、类型必须符合对照关系表,关系表如下:

实例数据库引擎名称-Engine 实例数据库版本号-EngineVersion 实例类型-DBInstanceType
高可用实例 mysql 5.5 HRDS
mysql 5.6 HRDS
mysql 5.7 HRDS
mysql 8.0 HRDS
单实例 percona 5.6 SINGLERDS
企业版 consistent_mysql 5.7 ERDS
云盘版 ebs_mysql 5.6 CDS_HRDS
ebs_mysql 5.7 CDS_HRDS

请求参数

英文名称 中文名称 类型 是否必须 备注
Action 调用接口名称 String 取固定值:CreateDBInstance
Version API版本号 String 取固定值:2016-07-01
Mem 内存大小 Integer 客户只能购买特定规格的套餐,否则将会报错
Disk 磁盘大小 Integer 客户只能购买特定规格的套餐,否则将会报错
DBInstanceName 实例名称 String 不超过256个字节,仅支持中文、大小写字母、数字、减号和下划线
Engine 实例中数据库引擎的名称 String 区分大小写,取值范围:mysql、percona,企业版:consistent_mysql(5.7),云盘版:ebs_mysql(5.6/5.7)
EngineVersion 实例中数据库引擎的版本 String 取值范围:其中mysql支持:5.5、5.6、5.7、8.0;其中percona支持:5.6
MasterUserPassword 数据库用户密码 String 8-30个字符,必须包含大小写字母和数字,支持的特殊字符为[email protected]#$%^&*()_+=-
MasterUserName 数据库用户名 String root, rdsrepladmin, rdsadmin不可用
DBInstanceType 数据库类型 String 区分大小写,取值范围:高可用实例:HRDS、单实例:SINGLERDS、企业版:ERDS、云盘版:CDS_HRDS
VpcId VPC domain_id String VPC网络ID,可在网络控制台获取。
SubnetId VPC vnet_id String 终端子网ID,可在网络控制台获取(注意类型必须为终端子网)。
PreferredBackupTime 自动备份发起时间范围 String 格式(hh:mm-hh:mm,如:01:00-02:00),如不指定后台将随机分配
DBParameterGroupId 参数组id String 指定实例的参数组,如不指定,系统将采用默认的参数组来创建实例。用户需事先在控制台创建好参数组。
SecurityGroupId 安全组id String 安全组id,不传入默认为空
Port 数据库连接端口 String 默认3306
BillType 计费方式 String 默认值:YEAR_MONTH,取值范围:YEAR_MONTH(包年包月),DAY(按日计费)。
Duration 购买时长 String 默认值:1
DurationUnit 购买时长单位 String 取值范围:M(月),默认值:M(区分大小写)
AvailabilityZone.N 可用区字段 String 示例(AvailabilityZone.1=cn-beijing-6a&AvailabilityZone.2=cn-beijing-6b),表示实例的主副本在a区,备副本在b区。如果没有跨可用区的需求,建议将实例创建在云主机的可用区内已减少网络延时。其中企业版ERDS可用区为3个(1主2备)
ProjectId 项目Id Integer 可从IAM获取ProjectId。可按项目来进行细粒度权限控制,将实例归类到某个项目下

返回值

英文名称 中文名称 类型 备注
RequestId 请求ID String
DBInstance RDS实例信息 DBInstance

请求示例

http://krds.api.ksyun.com/?Action=CreateDBInstance&DBInstanceName=test&DBInstanceType=HRDS&Engine=mysql&EngineVersion=5.7&MasterUserName=admin&MasterUserPassword=Shangdi123&Version=2016-07-01&VpcId=3c12ccdf-9b8f-4d9b-8aa6-a523897e97a1&SubnetId=293c16a5-c757-405c-a693-3b2a3adead50&BillType=DAY&Mem=1&Disk=5&ProjectId=0

示例返回

{
    "Data": {
        "DBInstance": {
            "DBInstanceClass": {
                "Id": "RDSOpenAPI_43e19b9291d6b519",
                "Iops": 1200,
                "Vcpus": 1,
                "Disk": 5,
                "Ram": 1,
                "Mem": 1,
                "MaxConn": 200
            },
            "DBInstanceIdentifier": "06961b1a-b7e9-449d-a953-ce3cf5aaa934",
            "DBInstanceName": "KingSoft_Test",
            "DBInstanceStatus": "CREATING",
            "DBInstanceType": "HRDS",
            "DBParameterGroupId": "4f88478e-4fa2-4a5d-b64b-4c0119aa9565",
            "PreferredBackupTime": "22:00-23:00",
            "GroupId": "0b5aa180-e884-4fd6-8bed-04b4abb09f59",
            "Vip": "0.0.0.0",
            "Port": 3306,
            "Engine": "mysql",
            "EngineVersion": "5.7",
            "InstanceCreateTime": "2021-07-28T10:29:01+0800",
            "MasterUserName": "admin",
            "DatastoreVersionId": "2ddf87e5-5498-4ceb-ba2f-da6f69ae0949",
            "VpcId": "3c12ccdf-9b8f-4d9b-8aa6-a523897e97a1",
            "SubnetId": "293c16a5-c757-405c-a693-3b2a3adead50",
            "PubliclyAccessible": true,
            "BillType": "DAY",
            "OrderType": "REGULAR",
            "MultiAvailabilityZone": false,
            "AvailabilityZoneList": [],
            "DiskUsed": 0.0,
            "Audit": false,
            "ReadReplicaDBInstanceIdentifiers": [],
            "ProductId": "8ba4b19a-a1c2-4cf5-a47b-f8d666ecb4bd",
            "ProductWhat": 1,
            "ProjectId": 0,
            "ProjectName": "默认项目",
            "Region": "cn-shanghai-3",
            "ServiceStartTime": "2021-07-28T10:29:01+0800",
            "SubOrderId": "HRDS2S210728102901963208D5Q",
            "SecurityGroups": [],
            "SupportIPV6": false,
            "BillTypeId": 5
        }
    },
    "RequestId": "1db5287d-162a-4ff2-85fa-b65504cc15d0"
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈