調用CreateDB接口創建數據庫。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 CreateDB

系統規定參數。取值：CreateDB。

RegionId String 是 cn-hangzhou

實例所在地域。
DBInstanceName String 是 pxc-**************

實例名稱。
AccountName String 是 testaccount

創建的數據庫授權的指定賬號名稱。
Charset String 是 utf8mb4

字符集，支持如下字符集：

  • utf8
  • gbk
  • latin1
  • utf8mb4
DbName String 是 testdb

創建的數據庫名稱。
AccountPrivilege String 是 ReadWrite

給新創建的賬號授權某數據庫的權限，包括：

  • ReadWrite
  • ReadOnly
  • DMLOnly
  • DDLOnly
DbDescription String 否 db for test

數據庫描述信息。
SecurityAccountName String 否 securityAccount

安全管理員賬號名稱。

說明 若已開啟三權分立模式，該參數必填，未開啟三權分立可以不填。
SecurityAccountPassword String 否 securityPassword

安全管理員賬號密碼。

說明 若已開啟三權分立模式，該參數必填，未開啟三權分立可以不填。
Mode String 否 auto

創建數據庫時選擇的模式，取值如下：

  • auto：該模式的數據庫支持自動分區，即創建表時無需指定分區鍵；
  • drds：該模式的數據庫不支持自動分區，創建表時需使用專用的分庫分表語法，指定分庫分表鍵。

返回數據

名稱 類型 示例值 描述
Message String *****

成功為空，失敗返回錯誤信息。
RequestId String 9B2F3840-5C98-475C-B269-2D5C3A31797C

請求ID。
Success Boolean true

請求是否成功。

示例

請求示例

http(s)://[Endpoint]/?Action=CreateDB
&RegionId=cn-hangzhou
&DBInstanceName=pxc-**************
&AccountName=testaccount
&Charset=utf8mb4
&DbName=testdb
&AccountPrivilege=ReadWrite
&DbDescription=db for test
&SecurityAccountName=securityAccount
&SecurityAccountPassword=securityPassword
&Mode=auto
&公共請求參數

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDBResponse>
    <Message>*****</Message>
    <RequestId>9B2F3840-5C98-475C-B269-2D5C3A31797C</RequestId>
    <Success>true</Success>
</CreateDBResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "*****",
  "RequestId" : "9B2F3840-5C98-475C-B269-2D5C3A31797C",
  "Success" : true
}

錯誤碼

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