全部文档
当前文档
最近更新时间：2024-08-14 10:24:50
创建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个字符，必须包含大小写字母和数字，支持的特殊字符为!@#$%^&*()_+=- |
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（按日计费）， HourlyInstantSettlement（按量付费）。 |
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。可按项目来进行细粒度权限控制，将实例归类到某个项目下 |
TableNamesAreCaseSensitive | 表名是否区分大小写 | Integer | 否 | 取值范围：1：表名不区分大小写 0：表名区分大小写。不传则默认为不区分大小写 |
英文名称 | 中文名称 | 类型 | 备注 |
|---|---|---|---|
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"
}纯净模式