调用 CreateDBInstance 接口创建实例。
异步请求。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
DBEngineVersion | String | 是 | MySQL_8_0 | 兼容版本。取值：
|
NodeInfo | Object[] | 是 | [
{
"NodeType": "Primary",
"ZoneId": "cn-beijing-a",
"NodeSpec": "rds.mysql.1c2g"
},
{
"NodeType": "Secondary",
"ZoneId": "cn-beijing-a",
"NodeSpec": "rds.mysql.1c2g"
},
{
"NodeType": "ReadOnly",
"ZoneId": "cn-beijing-a",
"NodeSpec": "rds.mysql.1c2g"
}
] | 实例规格配置。主节点和备节点有且只有 1 个，只读节点可选 0~10 个。云数据库 MySQL 版支持将主节点、备节点创建在不同可用区，但只读节点必须添加在主节点或备节点的可用区。 |
StorageType | String | 是 | LocalSSD | 实例存储类型。取值为 说明 在 ModifyDBInstanceSpec 接口中，如需设定 StorageSpace 参数，StorageType 参数为必传。 |
StorageSpace | Integer | 否 | 100 | 实例存储空间。取值范围：[20, 3000]，单位为 GB，步长 10GB。 |
InstanceType | String | 否 | DoubleNode | 实例类型。取值为 DoubleNode。 |
VpcId | String | 是 | vpc-2d70di2hrnbpc58ozfdx9**** | 私有网络（VPC） ID。可调用 DescribeVpcs 查询。 说明 不支持使用共享 VPC。 |
SubnetId | String | 是 | subnet-2d70dj20bob9c58ozfek6**** | 子网 ID。 可调用 DescribeSubnets 通过指定 VpcId 和 ZoneId （主节点或备节点所在的可用区）查询可用的子网。 |
InstanceName | String | 否 | Name123 | 实例名称。实例名称的命名规则如下：
|
SuperAccountName | String | 否 | Test1 | 高权限账号名称。不传此参数默认不创建高权限账号。
|
SuperAccountPassword | String | 否 | Test@123456 | 高权限账号的密码。密码规则如下：
|
LowerCaseTableNames | String | 否 | 1 | 表名是否区分大小写，默认取值为“1”。后端忽略大小写。
|
DBTimeZone | String | 否 | UTC +08:00 | 时区。支持 UTC -12:00 ~ +13:00。默认值为 Region 所在的 TimeZone。 |
DBParamGroupId | String | 否 | mysql-sys-6013c7b8f7ef**** | 参数模板 ID。默认值为数据库引擎版本对应的默认参数模板。 |
ProjectName | String | 否 | Test | 实例所属的项目。如需在创建时指定项目，需确保项目已存在。可通过调用 ListProjects 接口查询项目列表，也可通过调用 CreateProject 接口创建新的项目。 |
ChargeInfo | Object | 是 | {
"ChargeType": "PostPaid"
} | 付费方式。 |
AllowListIds | String[] | 否 | [
"acl-a29be2559dc4406883d358892b90****",
"acl-ded4c0b707e44efd8f0dbc4e88f5****"
] | 白名单 ID。如需绑定多个白名单，白名单 ID 用英文逗号（,）分隔。一个实例最多可绑定 100 个白名单。 |
Port | Integer | 否 | 3306 | 默认终端的私网端口。端口号的取值范围为 1000~65534，默认值为 3306。 创建新的连接终端或开启新地址时，将使用默认终端的私网端口实时配置为默认端口。 |
InstanceTags | Object[] | 否 | [{"Key":"key", "Value":"value"}] | 实例标签。 |
MaintenanceWindow | Object | 否 | {
"DayKind": "Week",
"DayOfWeek": [ ,
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
]
"MaintenanceTime": "18:00Z-21:59Z"
} | 在创建实例时指定实例的可维护时间段。该字段为可选，不设置时默认为一周内每一天的 UTC18:00Z-21:59Z（即北京时间 02:00-05:59）。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
InstanceId | String | mysql-06f13c93**** | 实例 ID。 |
OrderId | String | Order709899242175681**** | 订单 ID。 |
POST /?Action=CreateDBInstance&Version=2022-01-01 HTTP/1.1 Content-Type: application/json Host: rds.volcengineapi.com X-Date: 20211202T101010Z Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458**** { "DBEngineVersion": "MySQL_5_7", "NodeInfo": [ { "NodeType": "Primary", "ZoneId": "cn-beijing-a", "NodeSpec": "rds.mysql.1c2g" }, { "NodeType": "Secondary", "ZoneId": "cn-beijing-b", "NodeSpec": "rds.mysql.1c2g" } ], "StorageType": "LocalSSD", "StorageSpace": 20, "SubnetId": "subnet-2gcy3ey5i9reo50ztyzo6****", "VpcId": "vpc-3jhamu8itr5ds3pncmf9q****", "AllowListIds": [ "acl-3929ba6fd27049e88ee772dc7b46****" ], "Port": 3306, "InstanceName": "测试样例", "ChargeInfo": { "ChargeType": "PostPaid", "Number": 1 }, "MaintenanceWindow": { "DayKind": "Week", "DayOfWeek": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "MaintenanceTime": "18:00Z-21:59Z" } }
{ "ResponseMetadata": { "RequestId": "20230508104043BEB227FB89B4F73A1436", "Action": "CreateDBInstance", "Version": "2022-01-01", "Service": "rds_mysql", "Region": "cn-beijing" }, "Result": { "InstanceId": "mysql-06f13c93****", "OrderId": "Order7230634971667632428" } }
更多详情，请参见错误码。