云数据库RDS

    创建主实例

    前提条件

    创建实例需要实名认证,没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证。

    说明

    • 本接口用于创建一个或多个相同配置的云数据库 RDS 实例。
    • 创建计费方式为后付费的实例需要账户现金余额+通用代金券大于100;预付费方式的实例则需要账户现金余额大于等于实例费用。
    • 支持批量创建,且如果创建过程中有一个实例创建失败,所有实例将全部回滚,均创建失败。
    • 创建接口为异步创建,可通过查询指定实例详情接口查询实例状态。

    请求结构

    POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
    HOST: rds.bj.baidubce.com
    Authorization: authorization string
    
    {
        "billing":{
            "paymentTiming": paymentTiming,
            "reservation": {
                "reservationLength": reservationLength
            }
        },
        "purchaseCount"                : purchaseCount,
        "instanceName"              : instanceName,
        "engine"                    : engine,
        "engineVersion"             : engineVersion,
        "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参数 计费相关参数。结构及取值参考
    purchaseCount int RequestBody参数 批量创建云数据库 RDS 实例个数, 最大不超过10;默认1
    instanceName string RequestBody参数 1)用户自定义实例名;
    2)允许小写字母、数字;
    3)长度限制为1~32;
    4) 默认命名规则:{engine} + {engineVersion}。
    engine string RequestBody参数 数据库引擎。
    MySQL;SQLServer;PostgreSQL。详情参考
    engineVersion string RequestBody参数 数据库版本,
    MySQL:5.5/5.6/5.7;
    SQLServer:2008r2/2012sp3/2016sp1;
    PostgreSQL:9.4
    category string RequestBody参数 所属系列。
    Basic:单机基础版,Standard:双机高可用版。
    仅SQLServer 2012sp3 支持单机基础版。默认Standard。详情参考
    cpuCount int RequestBody参数 CPU核数。取值参考
    memoryCapacity int RequestBody参数 套餐内存大小,单位GB。取值参考
    volumeCapacity int RequestBody参数 套餐磁盘大小,单位GB。每5G递增。范围参考
    zoneNames List String RequestBody参数 指定zone信息,默认为空,由系统自动选择,可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是小写的“国家-region-可用区序列",例如北京可用区A为"cn-bj-a"。
    vpcId string RequestBody参数 vpc,如果不提供则属于默认vpc。可通过调用 查询VPC列表接口查询可用的VPC
    isDirectPay Boolean RequestBody参数 是否进行直接支付,默认false,设置为直接支付的变配订单会直接扣款,不需要在走支付逻辑
    subnets List SubnetMap RequestBody参数 vpc内,每个可用区的subnetId;如果不是默认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?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":"Prepaid",
    	   "reservation": {
    	       "reservationLength": 1
    	   }
    	},
    	"purchaseCount":1,
    	"instanceName":"name-01",
    	"engine":"mysql",
    	"engineVersion":"5.6",
    	"cpuCount":1,
    	"memoryCapacity":0.25,
    	"volumeCapacity":5,
    	"zoneNames":["cn-bj-a"],
        "vpcId": "vpc-IyrqYIQ7",
        "isDirectPay": isDirectPay,
        "subnets":[
        {
        	"zoneName": "cn-bj-a",
        	"subnetId": "sbn-IyWRnII7"
        }
        ],
        "tags": [
            {
                "tagKey": "goods_type",
                "tagValue": "music"
            }
        ]
    }

    返回示例

    {
        "instanceIds":["rds-sgrw14145"]
    }
    上一篇
    SampleCode
    下一篇
    创建只读实例