创建主实例(已弃用)
更新时间:2022-11-17
接口说明
创建主实例
请求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 |
TagsItem字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| tagKey | String | 否 | goods_type | |
| tagValue | String | 否 | music |
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| instanceIds | List<String> | 实例ID列表 |
请求示例
JSON
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}
响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "instanceIds" : [ "rds-cwerfq23f", "rds-cwerfq23f" ]
6}
错误码
请参考通用错误码
评价此篇文章
