CreateAccount操作を呼び出して、ApsaraDB RDSインスタンス上のデータベースを管理するために使用されるアカウントを作成できます。
この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。
- インスタンスのステータスは [実行中] です。
- データベースが実行中の状態であること。
- インスタンスに作成されたアカウントの数は、インスタンスの最大アカウント数を超えていません。 アカウントの最大数の詳細については、「制限」をご参照ください。
説明
- この操作は、MySQL、MariaDB TX、PostgreSQL、およびSQL Serverを実行するインスタンスでサポートされています。 ただし、インスタンスがRDS Cluster EditionでSQL Server 2017またはSQL Server 2019を実行している場合、この操作はサポートされていません。
- PostgreSQLを標準SSDまたは拡張SSD (ESSD) で実行するApsaraDB RDSインスタンスごとに、複数の特権アカウントと複数の標準アカウントを作成できます。
- PostgreSQL 9.4またはPostgreSQL 10.0をローカルSSDで実行するApsaraDB RDSインスタンスごとに、特権アカウントを1つだけ作成できます。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateAccount | 実行する操作です。 値をCreateAccountに設定します。 |
DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxx | インスタンスの ID です。 DescribeDBInstancesを呼び出して、インスタンスのIDを照会できます。 |
AccountName | String | 必須 | test1 | アカウントのユーザー名。 説明
|
AccountPassword | String | 必須 | Test123456 | アカウントのパスワードを入力します。 説明
|
AccountDescription | String | 任意 | Test account A | アカウントについての説明を設定しま。 説明は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。 説明 http:// または https:// で始めることはできません。 |
アカウントタイプ | String | 任意 | ノーマル | アカウントのタイプ。 有効な値:
デフォルト値は、Normal です。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
RequestId | String | D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD | リクエストの ID です。 |
例
リクエストの例
http(s):// rds.aliyuncs.com/?Action=CreateAccount
&DBInstanceId=rm-uf6wjk5xxxxxxx
&AccountName=test1
&AccountPassword=Test123456
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateAccountResponse>
<RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</RequestId>
</CreateAccountResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | GeneralIns.Creating | 一般インスタンスは作成中です。 | インスタンスが作成中の場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
400 | GeneralIns.Maintaining | 一般的なインスタンスは維持中です。 | インスタンスが移行または保守中の場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
400 | GeneralIns. スイッチング | 一般的なインスタンスはスイッチングです。 | 高可用性を確保するためにプライマリ /セカンダリの切り替えが実行されている場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
400 | InvalidEngineVersion.NotSupported | 現在のdbインスタンスはsysadminをサポートしていません。 | 現在のインスタンスがインスタンスのsysAdminアカウントの作成をサポートしていない場合に返されるエラーメッセージ。 |
400 | Database.ConnectError | データベース接続エラー。 インスタンスのステータスとデータベースのprocesslistを確認してください | データベース接続が異常な場合に返されるエラーメッセージ。 データベースのインスタンスステータスと接続プールを確認します。 |
400 | Account.AddError | アカウントの作成に失敗しました。入力値を確認するか、入力値がインスタンスの現在のポリシーを満たしていない場合があります | アカウントの作成に失敗した場合に返されるエラーメッセージ。 リクエストパラメーターまたはリクエストパラメーターがパラメーター設定の要件を満たしているかどうかを確認します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。