CreateDatabase操作を呼び出して、インスタンスにデータベースを作成できます。

データ変更やスキーマ設計などのデータ管理タスクを実行する場合は、データ管理 (DMS) を使用します。 詳細については、「DMSの機能による操作の一覧」をご参照ください。

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

  • インスタンスのステータスは [実行中] です。
  • インスタンスのデータベースの最大数に達していません。 DescribeDBInstanceAttributeを呼び出して、データベースの最大数を照会できます。
  • インスタンスは読み取り専用インスタンスではありません。
    説明 この操作は、SQL Server 2017 EE (クラスタエディション) を実行するインスタンス、またはPostgreSQLを実行し、ローカルSSDを使用するインスタンスではサポートされません。 インスタンスがこれらのデータベースエンジンバージョンのいずれかを実行している場合、CREATE databaseステートメントを実行してデータベースを作成できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 CreateDatabase

実行する操作です。 値をCreateDatabaseに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。

DBName String 必須 rds_mysql

データベースの名前。

説明
  • 長さは 2 文字から 64 文字です。
  • アカウント名は、小文字で始まり、小文字または数字で終わる必要があります。
  • 小文字、数字、下線 (_)、およびハイフン (-) が使用できます。
  • 名前はインスタンス内で一意である必要があります。
  • 無効な文字の詳細については、「Forbidden keywords table」をご参照ください。
CharacterSetName String 必須 gbk

文字セット。

  • MySQLまたはMariaDB TXデータベースの有効な値: 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データベースの有効な値: 文字セット <Collate >,< Ctype> 形式の値。 例: UTF8,C,en_US.utf8
    • 文字セットの有効値: KOI8U、ULALATF8、WIN866、ISO8LALA_5974、WIN88881251、WIN1252、WIN1253、WIN1254、WIN1255、WIN1256、WIN1257、WIN1258、EUC_CN、EUC_KR、EUC_59LA_59LA_JP、EUC_59LA_TIN_6、MULE_TIN_TIN6、6、INLA_TIN_4、INLA_4、7、INLA_INLA_LA_LA_LA_4およびSQL_ASCII
    • Collateフィールドの有効な値: SELECT DISTINCT collname FROM pg_collation; ステートメントを実行して、フィールド値を取得できます。 デフォルト値はCです。
    • Ctypeフィールドの有効な値: SELECT DISTINCT collctype FROM pg_collation; ステートメントを実行して、フィールド値を取得できます。 デフォルト値はen_US.utf8です。
DBDescription String 任意 Test database

データベースの説明を記述します。 説明は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。

説明 説明はhttp:// またはhttps:// で始めることはできません。
ResourceGroupId String 任意 rg-acfmy *****

リソースグループの 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 形式

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
400 EngineMigration.ActionDisabled 指定されたアクションは、エンジン移行中に無効になります。 インスタンスのエンジン移行中に指定された操作が無効になった場合に返されるエラーメッセージ。
400 Database.AddError Dbの作成に失敗しました。入力値とインスタンスのステータスを確認してください データベースの作成に失敗した場合に返されるエラーメッセージ。 入力パラメーターとインスタンスのステータスを確認します。
400 Database.ConnectError データベース接続エラー。 インスタンスのステータスとデータベースのprocesslistを確認してください データベース接続が異常な場合に返されるエラーメッセージ。 データベースのインスタンスステータスと接続プールを確認します。

エラーコードリストについては、「API エラーセンター」をご参照ください。