云数据库RDS

    创建代理实例

    前提条件

    需要在云数据库 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 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"]
    }  
    上一篇
    创建只读实例
    下一篇
    查询实例列表