创建数据库 - 云数据库 RDS

如需进行数据变更、结构设计等数据管理任务，请使用数据管理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	数据库名称。说明长度为2~64个字符。以字母开头，以字母或数字结尾。由小写字母、数字、下划线或中划线组成。数据库名称在实例内必须是唯一的。其他非法字符，详见禁用关键字表。
CharacterSetName	String	是	gbk	字符集，取值： MySQL/MariaDB类型：utf8、gbk、latin1、utf8mb4 SQL Server类型：Chinese_PRC_CI_AS、Chinese_PRC_CS_AS、SQL_Latin1_General_CP1_CI_AS、SQL_Latin1_General_CP1_CS_AS、Chinese_PRC_BIN PostgreSQL类型：KOI8U、UTF8、WIN866、WIN874、WIN1250、WIN1251、WIN1252、WIN1253、WIN1254、WIN1255、WIN1256、WIN1257、WIN1258、EUC_CN、EUC_KR、EUC_TW、EUC_JP、EUC_JIS_2004、KOI8R、MULE_INTERNAL、LATIN1、LATIN2、LATIN3、LATIN4、LATIN5、LATIN6、LATIN7、LATIN8、LATIN9、LATIN10、ISO_8859_5、ISO_8859_6、ISO_8859_7、ISO_8859_8、SQL_ASCII
DBDescription	String	否	测试用数据库	数据库描述，长度为2~256个字符。以中文、英文字母开头，可以包含数字、中文、英文、下划线（_）、短横线（-）。说明不能以 http:// 和 https:// 开头。

返回数据


名称	类型	示例值	描述
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	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	数据库连接异常，请检查实例状态及数据库的连接池

访问错误中心查看更多错误码。