云数据库RDS

    创建只读实例

    前提条件

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

    说明

    • 仅数据库类型为 MySQL 的主实例支持创建只读实例
    • 只读实例的数据库引擎和数据库版本与主实例相同,无需设置,主实例版本最低是 MySQL 5.6
    • 只读实例的磁盘容量不能小于主实例的磁盘容量
    • 只读实例的 vpcId 需跟主实例一致
    • 一个云数据库 RDS 实例,最多只能有 5 个只读实例,且一次只能创建一个
    • 只读实例只支持后付费方式购买

    请求结构

    POST /v{version}/instance?readReplica&clientToken={clientToken} HTTP/1.1
    HOST: rds.bj.baidubce.com
    Authorization: authorization string
    
    {
        "billing":{
            "paymentTiming": paymentTiming,
            "reservation": {
                "reservationLength": reservationLength
            }
        },
        "sourceInstanceId"          : sourceInstanceId,
        "instanceName"              : instanceName,
        "cpuCount":cpuCount,
        "memoryCapacity"       : memoryCapacity,
        "volumeCapacity"      : volumeCapacity,
        "zoneNames":[zoneName],
        "vpcId": vpcId ,
        "isDirectPay": isDirectPay,
        "subnets":[
        {
        	"zoneName": zoneName,
        	"subnetId": subnetId
        }
        ],
        "tags": [
            {
                "tagKey": tagKey,
                "tagValue": tagValue
            }
        ]
    }

    请求头域

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

    请求参数

    参数名称 类型 是否必须 参数位置 描述
    version string URL参数 API 版本号
    clientToken string Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串。
    billing billing RequestBody参数 计费相关参数。
    只读实例只支持后付费Postpaid。结构及取值参考
    purchaseCount int RequestBody参数 批量创建云数据库 RDS 只读实例个数, 目前只支持一次创建一个.
    sourceInstanceId string RequestBody参数 主实例ID
    instanceName string RequestBody参数 用户自定义实例名,要求:
    1)允许小写字母、数字;
    2)长度限制为1~32;
    默认{engine} + {engineVersion}
    cpuCount int RequestBody参数 CPU核数。取值参考
    memoryCapacity int RequestBody参数 套餐内存大小,单位GB。取值参考
    volumeCapacity int RequestBody参数 套餐磁盘大小,单位GB,每5GB递增。不能小于主实例磁盘。范围参考
    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。可通过调用查询子网列表接口查询子网列表。
    只读实例只能在单可用区中,故此处只能填写一个 SubnetMap。
    tags List Tag RequestBody参数 实例绑定的标签信息

    SubnetMap

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

    Tag

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

    返回头域

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

    返回参数

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

    请求示例

    POST /v1/instance?readReplica&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"
    	},
    	"purchaseCount":1,
    	"instanceName":"mysql56",
    	"sourceInstanceId": "rds-mudjimy0jbig",
    	"cpuCount":1,
    	"memoryCapacity":0.25,
    	"volumeCapacity":5,
    	"zoneNames":["cn-bj-a"],
    	"vpcId": "vpc-IyrqYIQ7",
    	"subnets":[
    	{
    		"zoneName": "cn-bj-a",
    		"subnetId": "sbn-IyWRnII7"
    	}
    	],
        "tags": [
            {
                "tagKey": "goods_type",
                "tagValue": "music"
            }
        ]
    }

    返回示例

    {
        "instanceIds":["rds-cwerfq23f"]
    }
    上一篇
    创建主实例
    下一篇
    创建代理实例