Tous les produits
Search
Centre de documentation

:Créer une base de données

Dernière mise à jour :Aug 19, 2026

Appelez l'opération CreateDatabase pour créer une base de données sur une instance.

Pour gérer les données (modification, conception du schéma, etc.), utilisez Data Management (DMS). Pour plus d'informations, consultez la rubrique Liste des opérations par fonctionnalité de DMS.

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

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

  • Le nombre maximal de bases de données autorisées pour l'instance n'est pas atteint. Appelez l'opération DescribeDBInstanceAttribute pour connaître cette limite.

  • L'instance n'est pas une instance en lecture seule.

    Remarque

    Cette opération n'est pas prise en charge pour les instances exécutant SQL Server 2017 EE (édition cluster) ni pour les instances PostgreSQL utilisant des SSD locaux. Pour ces moteurs de base de données, exécutez l'instruction CREATE DATABASE.

Débogage

OpenAPI Explorer calcule automatiquement la signature. Nous vous recommandons d'utiliser cet outil pour appeler l'opération. Il génère également des exemples de code pour différents SDK.

Paramètres de requête

ParameterTypeRequiredExampleDescription
ActionStringYesCreateDatabase

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

DBInstanceIdStringYesrm-uf6wjk5xxxxxxxxxx

ID de l'instance.

DBNameStringYesrds_mysql

Nom de la base de données.

Remarque
  • Longueur comprise entre 2 et 64 caractères.
  • Doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.
  • Peut contenir des lettres minuscules, des chiffres, des traits de soulignement (_) et des traits d'union (-).
  • Doit être unique au sein de l'instance.
  • Pour la liste des caractères interdits, consultez le Tableau des mots clés interdits.
CharacterSetNameStringYesgbk

Jeu de caractères.

  • Bases de données MySQL ou MariaDB : utf8, gbk, latin1 et utf8mb4
  • Bases de données SQL Server : Chinese_PRC_CI_AS, Chinese_PRC_CS_AS, SQL_Latin1_General_CP1_CI_AS, SQL_Latin1_General_CP1_CS_AS et Chinese_PRC_BIN
  • Bases de données PostgreSQL : format Jeu de caractères,<Collate>,<Ctype>. Exemple : UTF8,C,en_US.utf8.
    • Jeu de caractères : KOI8U, UTF8, WIN866, WIN874, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, EUC_CN, EUC_KR, EUC_TW, EUC_JP, EUC_JIS_2004, KOI8R, MULE_INTERNAL, LATIN1, LATIN2, LATIN3, LATIN4, LATIN5, LATIN6, LATIN7, LATIN8, LATIN9, LATIN10, ISO_8859_5, ISO_8859_6, ISO_8859_7, ISO_8859_8 et SQL_ASCII
    • Champ Collate : exécutez l'instruction SELECT DISTINCT collname FROM pg_collation; pour obtenir les valeurs possibles. Valeur par défaut : C.
    • Champ Ctype : exécutez l'instruction SELECT DISTINCT collctype FROM pg_collation; pour obtenir les valeurs possibles. Valeur par défaut : en_US.utf8.
DBDescriptionStringNoTest database

Description de la base de données. Longueur comprise entre 2 et 256 caractères. Peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Doit commencer par une lettre.

Remarque Ne peut pas commencer par http:// ou https://.
ResourceGroupIdStringNorg-acfmy*****

ID du groupe de ressources.

Paramètres de réponse

Parameter Type Example Description
RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<CreateDatabaseResponse>
  <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>

Format JSON

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

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

Codes d'erreur

HTTP status code Error code Error message Description
400 EngineMigration.ActionDisabled Specified action is disabled while custins is in engine migration. L'opération spécifiée est désactivée pendant la migration du moteur de l'instance.
400 Database.AddError Create Db failed, please check input value and instance status Échec de la création de la base de données. Vérifiez les paramètres d'entrée et l'état de l'instance.
400 Database.ConnectError Database connect error. please check instance status and database processlist Erreur de connexion à la base de données. Vérifiez l'état de l'instance et la liste des processus de la base de données.

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