调用CreateDatabase接口在某个实例下创建数据库。
如需进行数据变更、结构设计等数据管理任务,请使用数据管理DMS。更多信息,请参见DMS API概览。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中。
- 实例中的数据库数量没有超出实例最大数据库数量,可以通过接口DescribeDBInstanceAttribute查询最大数据库数量。
-
实例类型不能为只读实例。说明 该接口暂不支持PostgreSQL(本地SSD盘)和SQL Server 2017集群版,您可以通过SQL做CREATE DATABASE操作。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDatabase |
系统规定参数。取值:CreateDatabase。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxxxxx |
实例ID。 |
DBName | String | 是 | rds_mysql |
数据库名称。 说明
|
CharacterSetName | String | 是 | gbk |
字符集,取值:
|
DBDescription | String | 否 | 测试用数据库 |
数据库描述,长度为2~256个字符。以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。 说明 不能以
http:// 和https:// 开头。
|
ResourceGroupId | String | 否 | rg-acfmy***** |
资源组ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 5A77D650-27A1-4E08-AD9E-59008EDB6927 |
请求 ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDatabaseResponse>
<RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | EngineMigration.ActionDisabled | Specified action is disabled while custins is in engine migration. | 实例在引擎迁移中时,指定的操作被禁用。 |
400 | Database.AddError | Create Db failed, please check input value and instance status | 创建数据库失败, 请检查输入参数及实例状态 |
400 | Database.ConnectError | Database connect error. please check instance status and database processlist | 数据库连接异常,请检查实例状态及数据库的连接池 |
访问错误中心查看更多错误码。