調用CreateDatabase介面在某個執行個體下建立資料庫。

調用該介面時，執行個體必須滿足以下條件，否則將操作失敗：

  • 執行個體狀態為運行中；
  • 執行個體中的資料庫數量沒有超出執行個體最大資料庫數量，可以通過介面DescribeDBInstanceAttribute查詢最大資料庫數量；
  • 執行個體類型不能為唯讀執行個體。
    说明 該介面暫不支援PostgreSQL、PPAS和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。
DBDescription String 否 測試用資料庫

資料庫描述，長度為2~256個字元。以中文、英文字母開頭，可以包含數字、中文、英文、底線（_）、虛線（-）。

说明 不能以 http:// 和 https:// 開頭。
AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰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 格式 

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

JSON 格式 

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。