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つだけ作成できます。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceIdString必須rm-uf6wjk5xxxxxxx

インスタンスの ID です。 DescribeDBInstancesを呼び出して、インスタンスのIDを照会できます。

AccountNameString必須test1

アカウントのユーザー名。

説明
  • ユーザー名は一意である必要があります。
  • ユーザー名は、小文字で始まり、小文字または数字で終わる必要があります。
  • 小文字、数字、アンダースコア (_) を使用できます。
  • ユーザー名の長さは、次の要件を満たす必要があります。
    • インスタンスがMySQL 5.7またはMySQL 8.0を実行する場合、ユーザー名は2 ~ 32文字である必要があります。
    • インスタンスがMySQL 5.6を実行する場合、ユーザー名は2〜16文字である必要があります。
    • インスタンスがSQL Serverを実行する場合、ユーザー名の長さは2 ~ 64文字である必要があります。
    • インスタンスが標準SSDまたはESSDでPostgreSQLを実行する場合、ユーザー名の長さは2 ~ 63文字である必要があります。
    • インスタンスがローカルSSDでPostgreSQLを実行する場合、ユーザー名は2〜16文字である必要があります。
    • インスタンスがMariaDB TXを実行する場合、ユーザー名は2 ~ 16文字である必要があります。
  • 無効な文字の詳細については、「Forbidden keywords table」をご参照ください。
AccountPasswordString必須Test123456

アカウントのパスワードを入力します。

説明
  • アカウントのパスワードは8〜32文字である必要があります。
  • アカウントのパスワードには、大文字、小文字、数字、および特殊文字のうち少なくとも3つの文字タイプを含める必要があります。
  • パスワードには次のいずれかの文字を使用できます。

    ! @ # $ % ^ & * ( ) _ + - =

AccountDescriptionString任意Test account A

アカウントについての説明を設定しま。 説明は2 ~ 256文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 説明は文字で始める必要があります。

説明 http:// または https:// で始めることはできません。
アカウントタイプString任意ノーマル

アカウントのタイプ。 有効な値:

  • 通常: 標準アカウント
  • Super: 特権アカウント

デフォルト値は、Normal です。

レスポンスパラメーター

項目データ型例:説明 
RequestIdStringD4D4BE8A-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 ステータスコードエラーコードエラーメッセージ説明 
400GeneralIns.Creating一般インスタンスは作成中です。インスタンスが作成中の場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。
400GeneralIns.Maintaining一般的なインスタンスは維持中です。インスタンスが移行または保守中の場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。
400GeneralIns. スイッチング一般的なインスタンスはスイッチングです。高可用性を確保するためにプライマリ /セカンダリの切り替えが実行されている場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。
400InvalidEngineVersion.NotSupported現在のdbインスタンスはsysadminをサポートしていません。現在のインスタンスがインスタンスのsysAdminアカウントの作成をサポートしていない場合に返されるエラーメッセージ。
400Database.ConnectErrorデータベース接続エラー。 インスタンスのステータスとデータベースのprocesslistを確認してくださいデータベース接続が異常な場合に返されるエラーメッセージ。 データベースのインスタンスステータスと接続プールを確認します。
400Account.AddErrorアカウントの作成に失敗しました。入力値を確認するか、入力値がインスタンスの現在のポリシーを満たしていない場合がありますアカウントの作成に失敗した場合に返されるエラーメッセージ。 リクエストパラメーターまたはリクエストパラメーターがパラメーター設定の要件を満たしているかどうかを確認します。

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