調用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"
}

錯誤碼

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