调用CreateDatabase接口在某个实例下创建数据库。

如需进行数据变更、结构设计等数据管理任务，请使用数据管理DMS。更多信息，请参见DMS API概览。

调用该接口时，实例必须满足以下条件，否则将操作失败：

  • 实例状态为运行中。
  • 实例中的数据库数量没有超出实例最大数据库数量，可以通过接口DescribeDBInstanceAttribute查询最大数据库数量。
  • 实例类型不能为只读实例。
    说明 该接口暂不支持PostgreSQL（本地SSD盘）、PPAS和SQL Server 2017集群版，您可以通过SQL做CREATE DATABASE操作。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateDatabase

系统规定参数，取值：CreateDatabase。

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
DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

实例ID。
DBName String 是 rds_mysql

数据库名称。

说明
  • 长度为2~64个字符。
  • 以字母开头，以字母或数字结尾。
  • 由小写字母、数字、下划线或中划线组成。
  • 数据库名称在实例内必须是唯一的。
  • 其他非法字符，详见禁用关键字表。
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 格式 

<CreateDatabaseResponse>
    <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>

JSON 格式 

{
    "RequestID":"5A77D650-27A1-4E08-AD9E-59008EDB6927"
  }

错误码

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