云数据库 RDS

产品文档

云数据库 RDS

createInstance

描述

创建一个RDS实例,用户可以使用相应的数据库客户端或者应用程序通过域名和端口链接到该RDS实例上,进行操作。

请求方式

POST

请求地址

https://rds.jdcloud-api.com/v1/regions/{regionId}/instances

名称 类型 是否必需 默认值 描述
regionId String True 地域代码,取值范围参见《各地域及可用区对照表》

请求参数

名称 类型 是否必需 默认值 描述
instanceSpec DBInstanceSpec True 新建实例规格

DBInstanceSpec

名称 类型 是否必需 默认值 描述
instanceName String False 实例名,具体规则可参见帮助中心文档:名称及密码限制
engine String True 实例引擎类型,参见枚举参数定义
engineVersion String True 实例引擎版本,参见枚举参数定义
instanceClass String True 实例规格代码,可以查看文档MySQL 实例规格SQL Server实例规格
instanceStorageGB Integer True 磁盘大小,单位GB,可以查看文档MySQL 实例规格SQL Server实例规格
azId String[ ] True 可用区ID, 第一个ID必须为主实例所在的可用区。如两个可用区一样,也需输入两个azId
vpcId String True VPC的ID
subnetId String True 子网ID
parameterGroup String False 参数组ID, 缺省系统会创建一个默认参数组
- 仅支持MySQL
chargeSpec ChargeSpec True 计费规格,包括计费类型,计费周期等
instanceStorageType String False 存储类型,参见枚举参数定义, 缺省值为:LOCAL_SSD
- 仅支持MySQL
instancePort String False 应用访问端口, 仅支持 MySQL,Percona, MariaDB, 默认值为 3306
storageEncrypted Boolean False 实例数据加密(存储类型为云硬盘才支持数据加密)。false:不加密,true:加密,缺省为false
- 仅支持MySQL
instanceType String False 实例的高可用架构。standalone:单机,cluster:主备双机架构,缺省为cluster
- 仅支持SQL Server

ChargeSpec

名称 类型 是否必需 默认值 描述
chargeMode String False postpaid_by_duration 计费模式,取值为:prepaid_by_duration,postpaid_by_usage或postpaid_by_duration,prepaid_by_duration表示预付费,postpaid_by_usage表示按用量后付费,postpaid_by_duration表示按配置后付费,默认为postpaid_by_duration.请参阅具体产品线帮助文档确认该产品线支持的计费类型
chargeUnit String False 预付费计费单位,预付费必填,当chargeMode为prepaid_by_duration时有效,取值为:month、year,默认为month
chargeDuration Integer False 预付费计费时长,预付费必填,当chargeMode取值为prepaid_by_duration时有效。当chargeUnit为month时取值为:1~9,当chargeUnit为year时取值为:1、2、3
autoRenew Boolean False True=:OPEN——开通自动续费、False=CLOSE—— 不开通自动续费,默认为CLOSE
buyScenario String False 产品线统一活动凭证JSON字符串,需要BASE64编码,目前要求编码前格式为 {"activity":{"activityType":必填字段, "activityIdentifier":必填字段}}

返回参数

名称 类型 描述
result Result

Result

名称 类型 描述
instanceId String

返回码

返回码 描述
200 OK

请求示例

POST

public void testCreateInstance() {
    CreateInstanceRequest request = new CreateInstanceRequest();
    DBInstanceSpec spec = new DBInstanceSpec();
    spec.setEngine("MySQL");
    spec.setEngineVersion("5.7");
    spec.setInstanceClass("db.mysql.s1.micro");
    spec.setInstanceStorageGB(20);
    spec.addAzId("cn-north-1a");
    spec.setVpcId("vpc-c58jvzx9eq");
    spec.setSubnetId("subnet-n9v3g73e8d");
    spec.setInstanceName("test");
    ChargeSpec chargeSpec = new ChargeSpec();
    chargeSpec.setChargeMode("postpaid_by_duration");
    spec.setChargeSpec(chargeSpec);
    request.setInstanceSpec(spec);
    request.setRegionId(region);
    CreateInstanceResponse response = rdsClient.createInstance(request);
    Gson gson = new GsonBuilder().create();
    System.out.println(gson.toJson(response));
}

返回示例

{
    "requestId": "bkut6f51mkggr76oja96kh64ehtag0mi", 
    "result": {
        "instanceId": "mysql-ocj6g73clt"
    }
}
更新时间:2019-11-15 15:44:12