CreateDatabase操作を呼び出して、インスタンスにデータベースを作成できます。
データ変更やスキーマ設計などのデータ管理タスクを実行する場合は、データ管理 (DMS) を使用します。 詳細については、「DMSの機能による操作の一覧」をご参照ください。
この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。
- インスタンスのステータスは [実行中] です。
- インスタンスのデータベースの最大数に達していません。 DescribeDBInstanceAttributeを呼び出して、データベースの最大数を照会できます。
- インスタンスは読み取り専用インスタンスではありません。説明 この操作は、SQL Server 2017 EE (クラスタエディション) を実行するインスタンス、またはPostgreSQLを実行し、ローカルSSDを使用するインスタンスではサポートされません。 インスタンスがこれらのデータベースエンジンバージョンのいずれかを実行している場合、CREATE databaseステートメントを実行してデータベースを作成できます。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateDatabase | 実行する操作です。 値をCreateDatabaseに設定します。 |
DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxxxxx | インスタンスの ID です。 |
DBName | String | 必須 | rds_mysql | データベースの名前。 説明
|
CharacterSetName | String | 必須 | gbk | 文字セット。
|
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 エラーセンター」をご参照ください。