CreateDBInstance
调用CreateDBInstance接口创建一个RDS实例。
关于RDS实例的规格,请参见实例规格表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDBInstance |
系统规定参数。取值:CreateDBInstance。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。可以通过接口DescribeRegions查看可用的地域ID。 |
Engine | String | 是 | MySQL |
数据库类型。取值:
|
EngineVersion | String | 是 | 5.6 |
数据库版本。取值:
|
DBInstanceClass | String | 是 | rds.mysql.s1.small |
实例规格。详情请参见实例规格表。 |
DBInstanceStorage | Integer | 是 | 20 |
实例存储空间。单位:GB。每5GB进行递增,取值范围请参见实例规格表。 |
DBInstanceNetType | String | 是 | Internet |
实例的网络连接类型。取值:
|
PayType | String | 是 | Postpaid |
实例的付费类型。取值:
|
SecurityIPList | String | 是 | 10.23.12.27/24 |
该实例的IP白名单。多个IP地址请以英文逗号(,)隔开,不可重复,最多1000个。支持如下两种格式:
|
SystemDBCharset | String | 否 | gbk |
字符集。取值:
说明 PostgreSQL字符集在创建数据库时指定,无需传入此参数。
|
DBInstanceDescription | String | 否 | 测试数据库 |
实例名称。长度为2~255个字符。以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。 说明 不能以 http:// 和 https:// 开头。
|
ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx |
用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
ZoneId | String | 否 | cn-hangzhou-b |
可用区ID。多可用区的格式与单可用区不同,包含MAZ字样,例如cn-hangzhou-MAZ6(b,f)、cn-hangzhou-MAZ5(b,e,f)。可以通过接口DescribeRegions查看可用区ID。 说明 指定了VPC和交换机时,为匹配交换机对应的可用区,该参数必填。
|
InstanceNetworkType | String | 否 | Classic |
实例的网络类型。取值:
默认创建经典网络类型的实例。 说明
|
ConnectionMode | String | 否 | Standard |
实例的访问模式。取值:
默认为RDS系统分配。 说明 SQL Server 2012/2016/2017只支持标准访问模式。
|
VPCId | String | 否 | vpc-xxxxxxxxxxxx |
VPC ID。 说明 如果数据库类型为MariaDB,该参数必填。
|
VSwitchId | String | 否 | vsw-xxxxxxxxxxx |
VSwitch ID。多个值用英文逗号(,)隔开。 说明 如果数据库类型为MariaDB,该参数必填。
|
PrivateIpAddress | String | 否 | 172.16.201.69 |
设置实例的内网IP。需要在指定交换机的IP地址范围内。系统默认通过VPCId和VSwitchId自动分配。 |
Period | String | 否 | Year |
指定预付费实例为包年或者包月类型。取值:
说明 若付费类型为Prepaid则该参数必须传入。
|
UsedTime | String | 否 | 2 |
指定购买时长。取值:
说明 若付费类型为Prepaid则该参数必须传入。
|
AutoRenew | String | 否 | true |
实例是否自动续费。取值:true | false 说明
|
DBInstanceStorageType | String | 否 | cloud_ssd |
实例存储类型。取值:
|
BusinessInfo | String | 否 | 121436975448952 |
业务扩展参数。 |
Category | String | 否 | HighAvailability |
实例系列。取值:
|
DedicatedHostGroupId | String | 否 | dhg-4nxxxxxxx |
在主机组内创建实例时指定主机组ID。 |
EncryptionKey | String | 否 | 0d24xxxx-da7b-4786-b981-9a164dxxxxxx |
同地域内的云盘加密的密钥ID。您可以在密钥管理服务控制台查看密钥ID,也可以创建新的密钥。详情请参见管理密钥。 说明 传入此参数表示开启云盘加密(开启后无法关闭),并且需要传入RoleARN。
|
RoleARN | String | 否 | acs:ram::1406xxxxxx:role/aliyunrdsinstanceencryptiondefaultrole |
主账号授权RDS云服务账号访问KMS权限的全局资源描述符(ARN)。您可以在RAM访问控制台复制ARN的内容。 说明 在控制台自助授权请参见授权RDS访问KMS。
|
TargetDedicatedHostIdForLog | String | 否 | i-bpxxxxxxx3 |
在主机组内创建实例时,指定日志实例的主机ID。 说明 暂不支持传入此参数。
|
TargetDedicatedHostIdForMaster | String | 否 | i-bpxxxxxxx1 |
在主机组内创建实例时,指定主实例的主机ID。 |
TargetDedicatedHostIdForSlave | String | 否 | i-bpxxxxxxx2 |
在主机组内创建实例时,指定备实例的主机ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBInstanceId | String | rm-uf6wjk5xxxxxxxxxx |
实例ID。 |
OrderId | String | 1007893702xxxxx |
订单ID。 |
ConnectionString | String | rm-uf6wjk5xxxxxxx.mysql.rds.aliyuncs.com |
数据库连接地址。 说明 参数DBInstanceNetType决定该地址为内网或外网。
|
Port | String | 3306 |
数据库连接端口。 说明 参数DBInstanceNetType决定该端口为内网或外网。
|
RequestId | String | 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&DBInstanceNetType=Internet
&PayType=Postpaid
&SecurityIPList=10.23.12.27/24
&<公共请求参数>
正常返回示例
XML
格式
<CreateDBInstanceResponse>
<OrderId>1007893702xxxxx</OrderId>
<ConnectionString>rm-uf6wjk5xxxxxxx.mysql.rds.aliyuncs.com</ConnectionString>
<DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
<Port>3306</Port>
<RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</CreateDBInstanceResponse>
JSON
格式
{
"Port":"3306",
"ConnectionString":"rm-uf6wjk5xxxxxxx.mysql.rds.aliyuncs.com",
"RequestId":"1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
"DBInstanceId":"rm-uf6wjk5xxxxxxx",
"OrderId":"1007893702xxxxx"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidZoneId.NotSupported | The Specified vpc Zone not supported. | 当前可用区不支持生产 VPC 实例,请您更换可用区再试。 |
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论