Tous les produits
Search
Centre de documentation

:Créer un compte de base de données

Dernière mise à jour :Aug 19, 2026

Appelez l'opération CreateAccount pour créer un compte permettant de gérer les bases de données sur une instance ApsaraDB RDS.

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

  • L'instance est à l'état Running.

  • La base de données est en cours d'exécution.

  • Le nombre de comptes créés sur l'instance ne dépasse pas le quota maximal par instance. Pour plus d'informations sur ce quota, consultez la rubrique Limites.

Remarque
  • Cette opération est prise en charge pour les instances exécutant MySQL, MariaDB, PostgreSQL et SQL Server. Toutefois, elle n'est pas disponible pour les instances SQL Server 2017 ou 2019 en édition Cluster.

  • Vous pouvez créer plusieurs comptes privilégiés et plusieurs comptes standard sur chaque instance ApsaraDB RDS exécutant PostgreSQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'y appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParameterTypeRequiredExampleDescription
ActionStringYesCreateAccount

Opération à effectuer. Définissez la valeur sur CreateAccount.

DBInstanceIdStringYesrm-uf6wjk5xxxxxxx

ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID.

AccountNameStringYestest1

Nom d'utilisateur du compte.

Remarque
  • Le nom d'utilisateur doit être unique.
  • Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.
  • Il peut contenir des lettres minuscules, des chiffres et des traits de soulignement (_).
  • Sa longueur doit respecter les exigences suivantes :
    • Pour MySQL 5.7 ou 8,0 : entre 2 et 32 caractères.
    • Pour MySQL 5.6 : entre 2 et 16 caractères.
    • Pour SQL Server : entre 2 et 64 caractères.
    • Pour PostgreSQL avec des disques SSD standard ou ESSD : entre 2 et 63 caractères.
    • Pour PostgreSQL avec des disques SSD locaux : entre 2 et 16 caractères.
    • Pour MariaDB : entre 2 et 16 caractères.
  • Pour plus d'informations sur les caractères interdits, consultez le Tableau des mots clés interdits.
AccountPasswordStringYesTest123456

Mot de passe du compte.

Remarque
  • Il doit comporter entre 8 et 32 caractères.
  • Il doit contenir au moins trois des types de caractères suivants : majuscules, minuscules, chiffres et caractères spéciaux.
  • Caractères autorisés :

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

AccountDescriptionStringNoTest account A

Description du compte. Elle doit comporter entre 2 et 256 caractères, commencer par une lettre et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-).

Remarque La description ne peut pas commencer par http:// ou https://.
AccountTypeStringNoNormal

Type de compte. Valeurs possibles :

  • Normal : compte standard
  • Super : compte privilégié

Valeur par défaut : Normal.

Paramètres de réponse

Parameter Type Example Description
RequestId String D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD

ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CreateAccount
&DBInstanceId=rm-uf6wjk5xxxxxxx
&AccountName=test1
&AccountPassword=Test123456
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<CreateAccountResponse>
       <RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</RequestId>
</CreateAccountResponse>

Format JSON

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

{
  "RequestId" : "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}

Codes d'erreur

HTTP status code Error code Error message Description
400 GeneralIns.Creating The general instance is creating. Une instance est en cours de création. Réessayez ultérieurement.
400 GeneralIns.Maintaining The general instance is maintaining. Une instance est en cours de migration ou de maintenance. Réessayez ultérieurement.
400 GeneralIns.Switching The general instance is Switching. Un basculement primaire/secondaire est en cours pour garantir la haute disponibilité. Réessayez ultérieurement.
400 InvalidEngineVersion.NotSupported Current db instance does not support sysadmin. L'instance actuelle ne prend pas en charge la création d'un compte sysAdmin.
400 Database.ConnectError Database connect error. please check instance status and database processlist La connexion à la base de données est anormale. Vérifiez l'état de l'instance et le pool de connexions de la base de données.
400 Account.AddError Create Account failed, please check your input value or may your input value not satisfy instance current policy Échec de la création du compte. Vérifiez que les paramètres de la requête respectent les exigences de configuration.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.