创建代理实例（已弃用）

更新时间：2022-11-17

前提条件

需要在云数据库 RDS 主实例的基础上进行创建。

说明

仅数据库类型为MySQL的主实例支持创建只读实例
代理实例套餐和主实例套餐绑定，主实例版本最低是MySQL 5.6
每个主实例最多可以创建1个代理实例
只支持后付费
需与主实例在同一vpc中

请求结构

POST /v{version}/instance?rdsproxy&clientToken={clientToken} HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string

{
    "billing":{
        "paymentTiming": paymentTiming,
        "reservation": {
            "reservationLength": reservationLength
        }
    },
    "sourceInstanceId"          : sourceInstanceId,
    "instanceName"              : instanceName,
    "nodeAmount":nodeAmount,
    "zoneNames":[zoneName],
    "vpcId": vpcId ,
    "subnets":[
    {
    	"zoneName": zoneName,
    	"subnetId": subnetId
    }
    ],
     "tags": [
        {
            "tagKey": tagKey,
            "tagValue": tagValue
        }
    ]
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必须	参数位置	描述
version	string	是	URL参数	API 版本号
clientToken	string	是	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。
billing	billing	是	RequestBody参数	计费相关参数。代理实例只支持后付费Postpaid。结构及取值参考
sourceInstanceId	string	是	RequestBody参数	主实例ID
instanceName	string	否	RequestBody参数	用户自定义实例名，要求： 1）允许小写字母、数字； 2）长度限制为1~32；默认为rdsproxy
nodeAmount	int	是	RequestBody参数	代理实例节点数。取值范围2，4，6，8，16。
zoneNames	List string	否	RequestBody参数	指定zone信息，默认为空，由系统自动选择，可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是小写的“国家-region-可用区序列"，例如北京可用区A为"cn-bj-a"。建议与主实例的可用区保持一致。
vpcId	string	否	RequestBody参数	与主实例vpcId相同
isDirectPay	Boolean	否	RequestBody参数	是否进行直接支付，默认false，设置为直接支付的变配订单会直接扣款，不需要在走支付逻辑
subnets	List SubnetMap	否	RequestBody参数	特定vpc内，可用区的subnetId；如果指定的vpcId为自定义vpc，则必须指定subnetId。可通过调用查询子网列表接口查询子网列表。建议与主实例的子网保持一致。
tags	List Tag	否	RequestBody参数	实例绑定的标签信息

SubnetMap

参数名称	类型	描述
zoneName	String	可用区
subnetId	String	子网Id

Tag

参数名称	类型	描述
tagKey	String	标签key
tagValue	String	标签value

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
instanceIds	List InstanceId	由InstanceId组成的数组

请求示例

POST /v1/instance?rdsproxy&clientToken={be31b98c-5e41-4838-9830-9be700de5a20} HTTP/1.1
HOST: rds.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
	"billing":{
   	     "paymentTiming":"Postpaid"
	},
	"instanceName":"mysql56",
	"sourceInstanceId": "rds-mudjimy0jbig",
        "nodeAmount":2,
	"zoneNames":["cn-bj-a"],
        "vpcId": "vpc-IyrqYIQ7",
        "subnets":[
        {
    	    "zoneName": "cn-bj-a",
    	    "subnetId": "sbn-IyWRnII7"
        }
       ],
    "tags": [
        {
            "tagKey": "goods_type",
            "tagValue": "music"
        }
    ]
}

返回示例

{
    "instanceIds":["rds-mj7c09d7ck0q"]
}