创建主实例(已弃用)
接口说明
创建主实例
请求URI
POST /v{version}/instance
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
参数位置 |
| version |
String |
是 |
API 版本号 |
version_example |
Path |
| clientToken |
String |
否 |
幂等性Token,是一个长度不超过64位的ASCII字符串 |
clientToken_example |
Query |
请求体参数
请求体字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| billing |
Billing |
是 |
计费相关参数 |
|
| autoRenewTimeUnit |
String |
是 |
自动续费周期单位,month:月;year:年; |
month |
| autoRenewTime |
Integer |
是 |
自动续费周期(续费单位为year 不大于3,续费单位为month 不大于9) |
1 |
| instanceName |
String |
否 |
实例名称 |
name-01 |
| purchaseCount |
Integer |
是 |
批量创建云数据库 RDS 实例个数, 最大不超过10;默认1 |
1 |
| engine |
String |
是 |
数据库引擎(MySQL;SQLServer;PostgreSQL) |
MySQL |
| engineVersion |
String |
是 |
数据库版本(MySQL:5.5/5.6/5.7; SQLServer:2008r2/2012sp3/2016sp1; PostgreSQL:9.4) |
5.7 |
| category |
String |
是 |
所属系列。 Basic:单机基础版,Standard:双机高可用版。 仅SQLServer 2012sp3 支持单机基础版。默认Standard。 |
Standard |
| cpuCount |
Integer |
是 |
CPU核数 |
1 |
| memoryCapacity |
Integer |
是 |
套餐内存大小,单位GB。 |
2 |
| volumeCapacity |
Integer |
是 |
套餐磁盘大小,单位GB。 |
5 |
| characterSetName |
String |
是 |
字符集,有"utf8mb4","latin1","gbk","utf8"可选,默认为"utf8"(目前只支持mysql主实例) |
utf8 |
| isDirectPay |
Boolean |
是 |
是否进行直接支付,默认false,设置为直接支付的变配订单会直接扣款,不需要在走支付逻辑 |
false |
| zoneNames |
List<String> |
否 |
指定zone信息,默认为空,由系统自动选择 |
|
| vpcId |
String |
否 |
vpc,如果不提供则属于默认vpc |
vpc-IyrqYIQ7 |
| subnets |
List<Subnets> |
否 |
vpc内,每个可用区的subnetId;如果不是默认vpc则必须指定 subnetId |
|
| tags |
List<Tags> |
否 |
标签 |
|
Billing字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| paymentTiming |
String |
是 |
付款方式(后付费:Postpaid;只读实例只支持后付费) |
Postpaid |
| reservation |
Reservation |
是 |
购买时长相关参数 |
|
Reservation字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| reservationLength |
Integer |
是 |
购买时长 |
1 |
| reservationTimeUnit |
String |
是 |
购买时长单位,Month:月,当前仅支持月 |
Month |
SubnetsItem字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| zoneName |
String |
否 |
|
cn-bj-a |
| subnetId |
String |
否 |
|
sbn-IyWRnII7 |
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| tagKey |
String |
否 |
|
goods_type |
| tagValue |
String |
否 |
|
music |
响应体参数
响应体字段数据结构说明
| 参数名称 |
参数类型 |
描述 |
示例值 |
| instanceIds |
List<String> |
实例ID列表 |
|
请求示例
1POST /vversion_example/instance?clientToken=clientToken_example
2<公共请求头>
3
4
5{
6 "engineVersion" : "5.7",
7 "volumeCapacity" : 5,
8 "zoneNames" : [ "cn-bj-a" ],
9 "instanceName" : "name-01",
10 "purchaseCount" : 1,
11 "characterSetName" : "utf8",
12 "autoRenewTime" : 1,
13 "isDirectPay" : false,
14 "autoRenewTimeUnit" : "month",
15 "billing" : {
16 "paymentTiming" : "Postpaid",
17 "reservation" : {
18 "reservationLength" : 1,
19 "reservationTimeUnit" : "Month"
20 }
21 },
22 "tags" : [ {
23 "tagValue" : "music",
24 "tagKey" : "goods_type"
25 } ],
26 "memoryCapacity" : 2,
27 "engine" : "MySQL",
28 "vpcId" : "vpc-IyrqYIQ7",
29 "subnets" : [ {
30 "subnetId" : "sbn-IyWRnII7",
31 "zoneName" : "cn-bj-a"
32 } ],
33 "category" : "Standard",
34 "cpuCount" : 1
35}
响应示例
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "instanceIds" : [ "rds-cwerfq23f", "rds-cwerfq23f" ]
6}
错误码
请参考通用错误码
![]()