Tous les produits
Search

Ce produit

    :Créer une instance

    Centre de documentation

    :Créer une instance

    Dernière mise à jour :Aug 08, 2026

    Vous pouvez appeler l'opération CreateDBInstance pour créer une instance ApsaraDB RDS.

    Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraDB RDS. Pour plus d'informations, consultez la rubrique Éléments facturables, méthodes de facturation et tarification.

    Pour en savoir plus sur les types d'instances ApsaraDB RDS, consultez la rubrique Types d'instances ApsaraDB RDS principales.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement un exemple de code pour l'opération adaptée à différents SDK.

    Paramètres de requête

    Parameter Type Required Example Description
    Action String Yes CreateDBInstance

    Opération que vous souhaitez effectuer. Définissez la valeur sur CreateDBInstance.

    RegionId String Yes cn-hangzhou

    ID de région de l'instance. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.

    Engine String Yes MySQL

    Moteur de base de données de l'instance. Valeurs valides :

    • MySQL
    • SQLServer
    • PostgreSQL
    • MariaDB
    Remarque Pour créer une instance serverless, vous devez définir ce paramètre sur MySQL.
    EngineVersion String Yes 5.6

    Version du moteur de base de données de l'instance.

    • Valeurs valides lorsque le paramètre Engine est défini sur MySQL : 5.5, 5.6, 5.7 et 8.0
    • Valeurs valides lorsque le paramètre Engine est défini sur SQLServer : 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha et 2019_ent
    • Valeurs valides lorsque le paramètre Engine est défini sur PostgreSQL : 10.0, 11.0, 12.0, 13.0, 14.0 et 15.0
    • Valeurs valides lorsque le paramètre Engine est défini sur MariaDB : 10.3
    Remarque Pour créer une instance serverless, vous devez définir ce paramètre sur 8.0.
    DBInstanceClass String Yes rds.mysql.s1.small

    Type d'instance de l'instance. Pour plus d'informations, consultez la rubrique Types d'instances ApsaraDB RDS principales. Vous pouvez également appeler l'opération DescribeAvailableResource pour interroger les types d'instances disponibles dans une région.

    Remarque Pour créer une instance serverless, vous devez définir ce paramètre sur mysql.n2.serverless.1c.
    DBInstanceStorage Integer Yes 100

    Capacité de stockage de l'instance. Unité : Go. Vous pouvez augmenter la capacité de stockage par paliers de 5 Go. Pour plus d'informations, consultez la rubrique Types d'instances ApsaraDB RDS principales. Vous pouvez également appeler l'opération DescribeAvailableResource pour interroger la plage de capacité de stockage prise en charge pour un type d'instance spécifié dans une région.

    SystemDBCharset String No gbk

    Jeu de caractères utilisé par l'instance. Ce paramètre est obsolète.

    DBInstanceNetType String Yes Internet

    Type de connexion réseau à l'instance. Valeurs valides :

    • Internet : Internet
    • Intranet : réseau interne
    DBInstanceDescription String No testdatabase

    Nom de l'instance. Le nom doit comporter entre 2 et 255 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom doit commencer par une lettre.

    Remarque Le nom ne peut pas commencer par http:// ou https://.
    SecurityIPList String Yes 10.10.XX.XX/24

    Liste d'autorisation IP de l'instance. Pour plus d'informations, consultez la rubrique Utiliser un client de base de données ou la CLI pour se connecter à une instance ApsaraDB RDS for MySQL. Si la liste d'autorisation IP contient plusieurs entrées, séparez-les par des virgules (,). Chaque entrée doit être unique. La liste d'autorisation IP peut contenir jusqu'à 1 000 entrées. Les entrées de la liste d'autorisation IP doivent respecter l'un des formats suivants :

    • Adresses IP, par exemple 10.10.XX.XX.
    • Blocs CIDR, par exemple 10.10.XX.XX/24. Dans cet exemple, 24 indique que le préfixe de chaque adresse IP de la liste d'autorisation IP a une longueur de 24 bits. Vous pouvez remplacer 24 par une valeur comprise entre 1 et 32.
    ClientToken String No ETnLKlblzczshOTUbOCz*****

    Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer qu'elle est unique parmi différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères.

    PayType String Yes Postpaid

    Méthode de facturation de l'instance. Valeurs valides :

    • Postpaid : paiement à l'utilisation.
    • Prepaid : abonnement.
    • Serverless : serverless. Cette valeur n'est prise en charge que pour les instances exécutant MySQL. Pour plus d'informations, consultez la rubrique Présentation.
    Remarque Le système génère automatiquement un bon de commande et effectue le paiement.
    ZoneId String No cn-hangzhou-b

    ID de zone de l'instance principale.

    Remarque
    • Si vous spécifiez un VPC et un vSwitch, vous devez définir ce paramètre sur l'ID de la zone à laquelle appartient le vSwitch spécifié. Sinon, l'instance ne peut pas être créée.
    • Si l'instance exécute RDS High-availability Edition, vous devez spécifier le paramètre ZoneIdSlave1, qui indique si la méthode de déploiement mono-zone ou multi-zone est utilisée.

    • Si l'instance exécute RDS Enterprise Edition, vous devez spécifier les paramètres ZoneIdSlave1 et ZoneIdSlave2, qui indiquent si la méthode de déploiement mono-zone ou multi-zone est utilisée.

    ZoneIdSlave1 String No cn-hangzhou-c

    ID de zone de l'instance secondaire. Si vous définissez le paramètre ZoneIdSlave1 sur la même valeur que le paramètre ZoneId, la méthode de déploiement mono-zone est utilisée. Si vous définissez le paramètre ZoneIdSlave1 sur une valeur différente du paramètre ZoneId, la méthode de déploiement multi-zone est utilisée.

    ZoneIdSlave2 String No cn-hangzhou-d

    ID de zone de l'instance de journalisation. Si vous définissez le paramètre ZoneIdSlave2 sur la même valeur que le paramètre ZoneId, la méthode de déploiement mono-zone est utilisée. Si vous définissez le paramètre ZoneIdSlave2 sur une valeur différente du paramètre ZoneId, la méthode de déploiement multi-zone est utilisée.

    InstanceNetworkType String No Classic

    Type de réseau de l'instance. Valeurs valides :

    • VPC.
    • Classic : réseau classique. Il s'agit de la valeur par défaut.
    Remarque
    • Si l'instance exécute MySQL et utilise des SSD standard ou des ESSD (Enhanced SSD), vous devez définir ce paramètre sur VPC.
    • Si l'instance exécute PostgreSQL ou MariaDB, vous devez définir ce paramètre sur VPC.
    • Si l'instance exécute SQL Server Basic ou SQL Server Web, vous pouvez définir ce paramètre sur VPC ou Classic. Si l'instance exécute d'autres moteurs de base de données, vous devez définir ce paramètre sur VPC.
    ConnectionMode String No Standard

    Mode de connexion de l'instance. Valeurs valides :

    • Standard : mode standard
    • Safe : mode proxy de base de données

    Le système attribue automatiquement un mode de connexion à l'instance.

    Remarque SQL Server 2012, SQL Server 2016 et SQL Server 2017 ne prennent en charge que le mode standard.
    VPCId String No vpc-*****

    ID du VPC.

    Remarque Si vous définissez le paramètre InstanceNetworkType sur VPC, vous devez également spécifier ce paramètre.
    VSwitchId String No vsw-*****

    ID du vSwitch. Le vSwitch doit appartenir à la zone spécifiée par le paramètre ZoneId.

    Remarque
    • Si vous définissez le paramètre InstanceNetworkType sur VPC, vous devez également spécifier ce paramètre.
    • Si vous spécifiez le paramètre ZoneSlaveId1, vous devez spécifier les ID de deux vSwitches pour ce paramètre et les séparer par une virgule (,).
    PrivateIpAddress String No 172.16.XX.XX

    Adresse IP privée de l'instance. L'adresse IP privée doit se trouver dans le bloc CIDR pris en charge par le vSwitch spécifié. ApsaraDB RDS attribue automatiquement une adresse IP privée à l'instance en fonction des valeurs des paramètres VPCId et vSwitchId.

    UsedTime String No 2

    Durée de l'abonnement de l'instance. Valeurs valides :

    • Si vous définissez le paramètre Period sur Year, la valeur du paramètre UsedTime varie de 1 à 5.
    • Si vous définissez le paramètre Period sur Month, la valeur du paramètre UsedTime varie de 1 à 11.
    Remarque Si vous définissez le paramètre PayType sur Prepaid, vous devez également spécifier ce paramètre.
    Period String No Year

    Unité de la durée de l'abonnement. Valeurs valides :

    • Year
    • Month
    Remarque Si vous définissez le paramètre PayType sur Prepaid, vous devez également spécifier ce paramètre.
    ResourceGroupId String No rg-acfmy*****

    ID du groupe de ressources auquel appartient l'instance.

    DBInstanceStorageType String Yes cloud_essd

    Type de stockage de l'instance. Valeurs valides :

    • local_ssd : SSD local. Il s'agit du type de stockage recommandé.
    • cloud_ssd : SSD standard. Ce type de stockage n'est pas recommandé. Les SSD standard ne sont plus disponibles à l'achat dans certaines régions Alibaba Cloud.
    • cloud_essd : ESSD de niveau de performance 1 (PL1).
    • cloud_essd2 : ESSD de PL2.
    • cloud_essd3 : ESSD de PL3.
    Remarque La valeur par défaut de ce paramètre est déterminée par le type d'instance spécifié par le paramètre DBInstanceClass.
    • Si le type d'instance spécifie le type de stockage SSD local, la valeur par défaut de ce paramètre est local_ssd.
    • Si le type d'instance spécifie le type de stockage SSD standard ou ESSD, la valeur par défaut de ce paramètre est cloud_essd.
    BusinessInfo String No 121436975448952

    Informations commerciales supplémentaires concernant l'instance.

    EncryptionKey String No 0d24*****-da7b-4786-b981-9a164dxxxxxx

    ID de la clé utilisée pour le chiffrement de disque dans la région où réside l'instance. Si vous spécifiez le paramètre EncryptionKey, le chiffrement de disque est automatiquement activé. Dans ce cas, vous devez également spécifier le paramètre RoleARN. Le chiffrement de disque ne peut pas être désactivé une fois activé.

    Vous pouvez obtenir l'ID de la clé depuis la console Key Management Service (KMS). Vous pouvez également créer une clé. Pour plus d'informations, consultez la rubrique Créer une CMK.

    RoleARN String No acs:ram::1406xxxxxx:role/aliyunrdsinstanceencryptiondefaultrole

    Alibaba Cloud Resource Name (ARN) fourni par votre compte Alibaba Cloud pour les utilisateurs RAM. Les utilisateurs RAM peuvent utiliser l'ARN pour connecter ApsaraDB RDS à KMS. Vous pouvez appeler l'opération CheckCloudResourceAuthorized pour interroger l'ARN.

    AutoRenew String No true

    Indique si la fonctionnalité de renouvellement automatique est activée pour l'instance. Vous devez spécifier ce paramètre uniquement lorsque l'instance utilise la méthode de facturation par abonnement. Valeurs valides :

    • true : active la fonctionnalité.
    • false : désactive la fonctionnalité.
    Remarque
    • Si vous définissez le paramètre Period sur Month, le cycle de renouvellement automatique est d'un mois.
    • Si vous définissez le paramètre Period sur Year, le cycle de renouvellement automatique est d'un an.
    Category String No HighAvailability

    Édition RDS de l'instance. Valeurs valides :

    • Basic : RDS Basic Edition

    • HighAvailability : RDS High-availability Edition

    • AlwaysOn : RDS Cluster Edition pour SQL Server
    • Finance : RDS Enterprise Edition
    • serverless_basic : RDS Serverless Basic Edition
      Remarque Si vous souhaitez créer une instance serverless, vous devez utiliser cette valeur.
    DedicatedHostGroupId String No dhg-4n*****

    ID du cluster dédié auquel appartient l'instance.

    Si vous créez l'instance dans un cluster dédié, vous devez spécifier ce paramètre.

    Remarque
    TargetDedicatedHostIdForMaster String No i-bp*****1

    ID de l'hôte auquel appartient l'instance dans le cluster dédié.

    Si vous créez l'instance dans un cluster dédié, vous devez spécifier ce paramètre. Si vous ne spécifiez pas ce paramètre, le système attribue automatiquement un hôte.

    Remarque
    • Vous pouvez appeler l'opération DescribeDedicatedHost pour interroger les détails des hôtes d'un cluster dédié.
    • Si aucun hôte n'a été créé, vous pouvez appeler l'opération CreateDedicatedHost pour créer un hôte.
    TargetDedicatedHostIdForSlave String No i-bp*****2

    ID de l'hôte auquel appartient l'instance secondaire dans le cluster dédié.

    Si l'instance exécute RDS High-availability Edition ou RDS Enterprise Edition et que vous créez l'instance dans un cluster dédié, vous devez spécifier ce paramètre. Si vous ne spécifiez pas ce paramètre, le système attribue automatiquement un hôte.

    Remarque
    • Vous pouvez appeler l'opération DescribeDedicatedHosts pour interroger les détails des hôtes d'un cluster dédié.
    • Si aucun hôte n'a été créé, vous pouvez appeler l'opération CreateDedicatedHost pour créer un hôte.
    TargetDedicatedHostIdForLog String No i-bp*****3

    ID de l'hôte auquel appartient l'instance de journalisation dans le cluster dédié.

    Si l'instance exécute RDS Enterprise Edition et que vous créez l'instance dans un cluster dédié, vous devez spécifier ce paramètre. Si vous ne spécifiez pas ce paramètre, le système attribue automatiquement un hôte.

    Remarque
    • Vous pouvez appeler l'opération DescribeDedicatedHosts pour interroger les détails des hôtes d'un cluster dédié.
    • Si aucun hôte n'a été créé, vous pouvez appeler l'opération CreateDedicatedHost pour créer un hôte.
    DBParamGroupId String No rpg-sys-*****

    ID du modèle de paramètres. Vous pouvez appeler l'opération DescribeParameterGroups pour interroger l'ID du modèle de paramètres.

    Remarque
    • Si vous souhaitez créer une instance exécutant RDS Basic Edition et utilisant le moteur de stockage X-Engine, vous devez appeler l'opération précédente, localiser le champ mysql_xengine_8.0_basic_normal_safe dans la réponse, trouver l'ID du modèle de paramètres système requis, puis utiliser cet ID comme valeur pour ce paramètre.
    • Si vous souhaitez créer une instance exécutant RDS High-availability Edition et utilisant le moteur de stockage X-Engine, vous devez appeler l'opération précédente, localiser le champ mysql_xengine_8.0_standard_normal_safe dans la réponse, trouver l'ID du modèle de paramètres système requis, puis utiliser cet ID comme valeur pour ce paramètre.
    DBTimeZone String No +08:00

    Fuseau horaire de l'instance. Ce paramètre prend effet uniquement lorsque vous définissez le paramètre Engine sur MySQL ou PostgreSQL.

    • Si vous définissez le paramètre Engine sur MySQL :
      • Le fuseau horaire de l'instance est en UTC. Valeurs valides : -12:59 à +13:00.
      • Si l'instance utilise des SSD locaux, vous pouvez spécifier le nom du fuseau horaire. Par exemple, vous pouvez spécifier le fuseau horaire Asia/Hong_Kong. Pour plus d'informations, consultez la rubrique Fuseaux horaires.
    • Si vous définissez le paramètre Engine sur PostgreSQL :
      • Le fuseau horaire de l'instance n'est pas en UTC. Pour plus d'informations, consultez la rubrique Fuseaux horaires.
      • Vous ne pouvez spécifier ce paramètre que lorsque l'instance exécute PostgreSQL avec des SSD standard ou des ESSD.
    Remarque
    • Si l'instance est une instance principale, vous pouvez spécifier ce paramètre. Si l'instance est une instance en lecture seule, vous ne pouvez pas spécifier ce paramètre. Une instance en lecture seule hérite du fuseau horaire de son instance principale.
    • Si vous ne spécifiez pas ce paramètre, le système attribue automatiquement le fuseau horaire par défaut de la région où réside l'instance.
    DBIsIgnoreCase String No true

    Indique si le nom de table est sensible à la casse. Valeurs valides :

    • true : Les noms de table ne sont pas sensibles à la casse. Il s'agit de la valeur par défaut.
    • false : Les noms de table sont sensibles à la casse.
    TargetMinorVersion String No rds_20200229

    Version mineure du moteur de l'instance. Ce paramètre est requis uniquement lorsque vous créez une instance exécutant MySQL ou PostgreSQL.

    Le format de la valeur varie selon le moteur de base de données de l'instance.

    • Si vous créez une instance ApsaraDB RDS for MySQL, la valeur est au format suivant : <Édition RDS>_<Version mineure du moteur>. Exemples : rds_20200229, xcluster_20200229 et xcluster80_20200229. La liste suivante décrit les champs des exemples de valeurs :
      • rds : L'instance exécute RDS Basic Edition ou High-availability Edition.
      • xcluster : L'instance exécute MySQL 5.7 sur RDS Enterprise Edition.
      • xcluster80 : L'instance exécute MySQL 8.0 sur RDS Enterprise Edition.
    Remarque Vous pouvez appeler l'opération DescribeDBMiniEngineVersions pour interroger la version mineure du moteur. Pour plus d'informations sur les versions mineures du moteur, consultez la rubrique Notes de version d'AliSQL.
    • Si vous créez une instance ApsaraDB RDS for PostgreSQL, la valeur est au format suivant : rds_postgres_<Version majeure du moteur>00_<Version mineure du moteur>. Exemple : rds_postgres_1400_20220830. La liste suivante décrit les champs de la valeur d'exemple :
      • 1400 : La version majeure du moteur est PostgreSQL 14.
      • 20220830 : version AliPG. Vous pouvez appeler l'opération DescribeDBMiniEngineVersions pour interroger la version AliPG. Pour plus d'informations sur les versions mineures du moteur, consultez la rubrique Notes de version d'AliPG.
    Remarque Si vous configurez le paramètre BabelfishConfig pour votre instance ApsaraDB RDS for PostgreSQL et définissez le champ babelfishEnabled sur true, la valeur de ce paramètre est au format suivant : rds_postgres_Version majeure du moteur00_Version AliPG_babelfish.
    StorageAutoScale String No Disable

    Indique si la fonctionnalité d'extension automatique du stockage est activée pour l'instance. Valeurs valides :

    • Enable.
    • Disable. Il s'agit de la valeur par défaut.
    Remarque Une fois l'instance créée, vous pouvez appeler l'opération ModifyDasInstanceConfig pour modifier les paramètres de la fonctionnalité d'extension automatique du stockage de l'instance. Pour plus d'informations, consultez la rubrique Configurer l'extension automatique du stockage pour une instance ApsaraDB RDS for MySQL.
    StorageThreshold Integer No 50

    Seuil en pourcentage déclenchant l'extension automatique du stockage.

    • 10
    • 20
    • 30
    • 40
    • 50
    Remarque Si vous définissez le paramètre StorageAutoScale sur Enable, vous devez également spécifier ce paramètre.
    StorageUpperBound Integer No 2000

    Capacité de stockage maximale autorisée pour l'extension automatique du stockage. La capacité de stockage de l'instance ne peut pas dépasser la capacité de stockage maximale. Unité : Go.

    • Valeurs valides : un entier supérieur ou égal à 0.
    • Si vous définissez le paramètre StorageAutoScale sur Enable, vous devez également spécifier ce paramètre.
    DryRun Boolean No false

    Indique si une vérification préalable doit être effectuée. Valeurs valides :

    • true : effectue une vérification préalable. Le système vérifie des éléments tels que les paramètres de requête, le format de requête, les limites de service et les ressources disponibles.
    • false : effectue une vérification préalable et envoie la requête. Si la requête passe la vérification préalable, l'opération est effectuée. Il s'agit de la valeur par défaut.
    UserBackupId String No 67798*****

    ID du fichier de sauvegarde. Vous pouvez appeler l'opération ListUserBackupFiles pour interroger les fichiers de sauvegarde. Si vous souhaitez créer une instance à l'aide des données d'un fichier de sauvegarde, vous devez spécifier ce paramètre.

    Remarque Ce paramètre est pris en charge uniquement lorsque les conditions suivantes sont remplies :
    • Le paramètre PayType est défini sur Postpaid.
    • Le paramètre Engine est défini sur MySQL.
    • Le paramètre EngineVersion est défini sur 5.7.
    • Le paramètre Category est défini sur Basic.
    Amount Integer No 2

    Nombre d'instances ApsaraDB RDS for MySQL que vous souhaitez créer. Le paramètre prend effet uniquement lorsque vous créez plusieurs instances ApsaraDB RDS for MySQL simultanément à l'aide d'une seule requête.

    Valeurs valides : 1 à 20. Valeur par défaut : 1.

    Remarque
    • Si vous souhaitez créer plusieurs instances ApsaraDB RDS for MySQL simultanément à l'aide d'une seule requête, vous pouvez ajouter des tags à toutes les instances à l'aide des paramètres Tag.N.Key et Tag.N.Value. Une fois les instances créées, vous pouvez les gérer en fonction des tags.
    • Après avoir soumis une requête pour créer plusieurs instances ApsaraDB RDS for MySQL, cette opération renvoie les paramètres TaskId, RequestId et Message. Vous pouvez appeler l'opération DescribeDBInstanceAttribute pour interroger les détails d'une instance.
    • Si la valeur du paramètre Engine n'est pas MySQL et que la valeur du paramètre Amount est supérieure à 1, cette opération échoue et renvoie un code d'erreur InvalidParam.Engine.
    CreateStrategy String No Atomicity

    Stratégie basée sur laquelle plusieurs instances sont créées. Le paramètre prend effet uniquement lorsque la valeur du paramètre Amount est supérieure à 1. Valeurs valides :

    • Atomicity : atomicité. Toutes les instances sont créées. Si une instance ne peut pas être créée, aucune des instances n'est créée.
    • Partial : non-atomicité. Chaque instance est créée indépendamment. L'échec de la création d'une instance n'affecte pas la création des autres instances.
    Remarque Valeur par défaut : Atomicity.
    Tag.N.Key String No testkey1

    Clé du tag N que vous souhaitez ajouter à l'instance. Vous pouvez utiliser ce paramètre pour ajouter des tags à l'instance.

    Remarque
    • Si la clé de tag spécifiée existe déjà, le système ajoute directement la clé de tag à l'instance. Vous pouvez appeler l'opération ListTagResources pour interroger les détails des tags existants.
    • Si la clé de tag spécifiée n'existe pas, le système crée la clé de tag et l'ajoute à l'instance.
    • La valeur de ce paramètre ne peut pas être une chaîne vide.
    • Ce paramètre doit être utilisé conjointement avec le paramètre Tag.N.Value.
    Tag.N.Value String No testvalue1

    Valeur du tag N ajoutée à l'instance. Vous pouvez utiliser ce paramètre pour ajouter des tags à l'instance.

    Remarque
    • Si la valeur de tag spécifiée est trouvée dans la clé de tag spécifiée, le système ajoute directement la valeur de tag à l'instance. Vous pouvez appeler l'opération ListTagResources pour interroger les détails des tags existants.
    • Si la valeur de tag spécifiée n'est pas trouvée dans la clé de tag spécifiée, le système crée la valeur de tag et l'ajoute à l'instance.
    • Ce paramètre doit être utilisé conjointement avec le paramètre Tag.N.Key.
    DeletionProtection Boolean No true

    Indique si la fonctionnalité de protection contre la suppression est activée pour l'instance.

    • true : active la fonctionnalité.
    • false : désactive la fonctionnalité. Il s'agit de la valeur par défaut.
    BabelfishConfig String No {"babelfishEnabled":"true","migrationMode":"single-db","masterUsername":"babelfish_user","masterUserPassword":"Babelfish123!"}

    Configuration de la fonctionnalité Babelfish pour l'instance ApsaraDB RDS for PostgreSQL.

    Format :{"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

    La liste suivante décrit les champs du format :

    • babelfishEnabled : indique si Babelfish est activé pour l'instance. Si vous définissez ce champ sur true, vous activez Babelfish pour l'instance. Si vous laissez ce paramètre vide, vous n'activez pas Babelfish pour l'instance.
    • migrationMode : mode de migration de l'instance. Valeurs valides : single-db et multi-db.
    • masterUsername : nom d'utilisateur du compte administrateur. Le nom d'utilisateur peut contenir des lettres minuscules, des chiffres et des traits de soulignement (_). Il doit commencer par une lettre et se terminer par une lettre ou un chiffre. Il peut comporter jusqu'à 63 caractères et ne peut pas commencer par pg.
    • masterUserPassword : mot de passe du compte administrateur. Le mot de passe doit contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Il doit comporter entre 8 et 32 caractères. Le mot de passe peut contenir l'un des caractères suivants : ! @ # $ % ^ & * ( ) _ + - =.
    Remarque Ce paramètre prend effet uniquement lorsque vous créez une instance ApsaraDB RDS for PostgreSQL. Pour plus d'informations, consultez la rubrique Présentation de Babelfish.
    ServerlessConfig Object No

    Paramètres de l'instance serverless. Ce paramètre est requis lors de la création d'une instance serverless.

    Remarque Ce paramètre prend effet uniquement lorsque vous créez une instance ApsaraDB RDS for MySQL.
    MaxCapacity double No 8

    Nombre maximal d'unités de capacité RDS (RCU). Valeurs valides : 0,5 à 8.

    Remarque La valeur de ce paramètre doit être supérieure ou égale à la valeur du paramètre MinCapacity.
    MinCapacity double No 0.5

    Nombre minimal de RCU. Valeurs valides : 0,5 à 8.

    Remarque La valeur de ce paramètre doit être inférieure ou égale à la valeur du paramètre MaxCapacity.
    AutoPause Boolean No true

    Indique si la fonctionnalité de démarrage et d'arrêt intelligents est activée pour l'instance serverless. Valeurs valides :

    • true : active la fonctionnalité.
    • false : désactive la fonctionnalité. Il s'agit de la valeur par défaut.
    Remarque Une fois la fonctionnalité de démarrage et d'arrêt intelligents activée, si aucune connexion à l'instance n'est établie dans les 10 minutes, l'instance est arrêtée. Après l'établissement d'une connexion à l'instance, celle-ci est automatiquement réactivée.
    SwitchForce Boolean No false

    Indique si la fonctionnalité de mise à l'échelle forcée est activée pour l'instance serverless. Valeurs valides :

    • true : active la fonctionnalité.
    • false : désactive la fonctionnalité. Il s'agit de la valeur par défaut.
    Remarque
    • Si vous définissez ce paramètre sur true, une interruption de connexion transitoire d'environ 1 minute se produit pendant le processus de mise à l'échelle forcée. Agissez avec prudence.
    • La mise à l'échelle des RCU pour une instance serverless prend effet immédiatement. Dans certains cas, tels que l'exécution de transactions volumineuses, la mise à l'échelle ne prend pas effet immédiatement. Dans ce cas, vous pouvez activer cette fonctionnalité pour forcer la mise à l'échelle des RCU de l'instance.
    ConnectionString String No rm-uf6wjk5*****.mysql.rds.aliyuncs.com

    Endpoint de l'instance.

    Remarque Le paramètre DBInstanceNetType spécifie si l'endpoint est un endpoint interne ou public.

    Paramètres de réponse

    Parameter Type Example Description
    DryRunResult Boolean true

    Indique si la requête a passé la vérification préalable. Valeurs valides :

    • true : La requête a passé la vérification préalable.
    • false : La requête n'a pas passé la vérification préalable.
      Remarque
      • Si le système n'effectue pas de vérification préalable, ce paramètre n'est pas renvoyé.
      • Si la requête n'a pas passé la vérification préalable, un message d'erreur est renvoyé.
    TagResult Boolean true

    Indique si le tag spécifié est ajouté à l'instance. Valeurs valides :

    • true : Le tag spécifié est ajouté à l'instance.
    • false : Le tag spécifié ne peut pas être ajouté à l'instance.
    Remarque Si vous n'ajoutez pas de tag à l'instance, ce paramètre n'est pas renvoyé.
    RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

    ID de la requête.

    ConnectionString String rm-uf6wjk5*****.mysql.rds.aliyuncs.com

    Endpoint de l'instance.

    Remarque Le paramètre DBInstanceNetType spécifie si l'endpoint est un endpoint interne ou public.
    Message String Batch Create DBInstance Task Is In Process.

    Message indiquant si plusieurs instances sont créées.

    Remarque Ce paramètre est renvoyé uniquement lorsque la valeur du paramètre Amount est supérieure à 1.
    DBInstanceId String rm-uf6wjk5*****

    ID de l'instance. Si la valeur du paramètre Amount est supérieure à 1, plusieurs ID d'instance sont renvoyés. Le nombre d'ID d'instance renvoyés correspond à la valeur du paramètre Amount. Les ID d'instance renvoyés sont séparés par des virgules (,).

    Par exemple, si la valeur du paramètre Amount est 3, trois ID d'instance sont renvoyés. Exemples :

    rm-uf6wjk5*****1,rm-uf6wjk5*****2,rm-uf6wjk5*****3
    Port String 3306

    Port de l'instance.

    Remarque Le paramètre DBInstanceNetType spécifie si le port est un port interne ou public.
    TaskId String s2365879-a9d0-55af-fgae-f2*****

    ID de la tâche exécutée pour créer plusieurs instances.

    Remarque
    • Ce paramètre est renvoyé uniquement lorsque la valeur du paramètre Amount est supérieure à 1.
    • Le paramètre TaskID ne peut pas être utilisé pour interroger une tâche.
    DryRun Boolean true

    Indique que le système a effectué une vérification préalable.

    Remarque
    • La valeur de retour est fixée à true.
    • Si le système n'effectue pas de vérification préalable, ce paramètre n'est pas renvoyé.
    OrderId String 1007893702*****

    ID de la commande.

    Remarque

    Dans la dernière version du SDK, le délai d'expiration par défaut côté client diffère du délai d'expiration par défaut côté instance. Si vous utilisez la dernière version du SDK pour appeler cette opération, un délai d'expiration peut être signalé même si l'opération est appelée avec succès. Pour éviter ce problème, vous pouvez définir le paramètre ReadTimeout sur 20000 avant d'appeler cette opération.

    Configure the setReadTimeout parameter

    Exemples

    Exemples de requêtes

    http(s)://rds.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=100
&DBInstanceNetType=Internet
&PayType=Postpaid
&SecurityIPList=10.23.XX.XX/24
&<Common request parameters>

    Exemples de réponses réussies

    XML format

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

<CreateDBInstanceResponse>
    <OrderId>1007893702*****</OrderId>
    <ConnectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</ConnectionString>
    <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
    <Port>3306</Port>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</CreateDBInstanceResponse>

    JSON format

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

{
  "OrderId" : "1007893702*****",
  "ConnectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
  "DBInstanceId" : "rm-uf6wjk5*****",
  "Port" : 3306,
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

    Codes d'erreur

    HTTP status code

    Error code

    Error message

    Description

    400

    InvalidInstanceLevel.DiskType

    Specified instance level not support request disk type

    Le message d'erreur renvoyé indique que le type d'instance spécifié ne prend pas en charge le type de stockage spécifié.

    400

    RR309

    We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.

    Le message d'erreur renvoyé indique que des risques de sécurité ont été détectés dans votre méthode de paiement. Cliquez sur le lien dans l'e-mail qui vous est envoyé ou dans la console ApsaraDB RDS pour poursuivre la vérification. Une fois la vérification terminée, soumettez à nouveau la commande.

    400

    InvalidZoneId.NotSupported

    The Specified vpc Zone not supported.

    Le message d'erreur renvoyé indique que la zone spécifiée ne vous permet pas de créer une instance dans un VPC. Spécifiez une autre zone et réessayez.

    400

    InvalidZone.NotSupportedForStorageType

    The specified zone is closed or invalid for Specified DBInstanceStorageType.

    Le message d'erreur renvoyé indique que la zone spécifiée n'est plus disponible ou que le paramètre DBInstanceStorageType spécifié est invalide.

    400

    InvalidZone.NotSupported

    The Specified Zone not supported.

    Le message d'erreur renvoyé indique que l'ID de région spécifié est invalide.

    400

    InvalidEssdStorageSize

    invalid cloud essd storage size.

    Le message d'erreur renvoyé indique que le type d'instance spécifié est invalide. Sélectionnez un type d'instance valide et réessayez.

    400

    IncompleteAccountInfo

    Your information is incomplete. Complete your information before the operation.

    Le message d'erreur renvoyé indique que les informations de votre compte sont incomplètes. Connectez-vous à la console Account Center et spécifiez tous les éléments d'information du compte marqués d'un astérisque (*). Vérifiez les éléments d'information dans la page Basic Information.

    400

    IncompleteTaxInfo

    Your tax information is incomplete. Complete your information before the operation.

    Le message d'erreur renvoyé indique que vos informations fiscales sont incomplètes. Spécifiez toutes les informations fiscales requises.

    400

    InvalidPaymentMethod.Incomplete

    No payment method is specified for your account. We recommend that you add a payment method.

    Le message d'erreur renvoyé indique qu'aucune méthode de paiement valide n'est fournie dans votre compte Alibaba Cloud. Ajoutez une méthode de paiement valide et réessayez.

    400

    InvalidPaymentMethod.Missing

    No payment method is specified for your account. We recommend that you add a payment method.

    Le message d'erreur renvoyé indique qu'aucune méthode de paiement valide n'est fournie dans votre compte Alibaba Cloud. Ajoutez une méthode de paiement valide et réessayez.

    400

    InsuffcientBalanceOrBankAccount

    Add a payment method or add funds to the prepayment balance. Get started by creating an instance.

    Le message d'erreur renvoyé indique qu'aucune méthode de paiement valide n'est fournie dans le compte Alibaba Cloud actuel. Ajoutez une méthode de paiement valide ou ajoutez des fonds au compte Alibaba Cloud actuel.

    400

    VswitchIpExhausted

    Vswitch IP exhausted.

    Le message d'erreur renvoyé indique que les adresses IP du vSwitch sont épuisées.

    400

    InvalidPrivateIpAddress.AlreadyUsed

    The specified IP is already used.

    Le message d'erreur renvoyé indique que l'adresse IP spécifiée est déjà utilisée.

    400

    InvalidConcurrentOperate

    Concurrent operation is detected.

    Le message d'erreur renvoyé indique que des opérations concurrentes sont en cours d'exécution dans le système. Attendez que l'opération précédente soit terminée et réessayez.

    400

    ZoneId.NotMatchWithCategory

    The number of ZoneId specified does not match with category.

    Le message d'erreur renvoyé indique que le nombre de zones que vous spécifiez n'est pas pris en charge pour le moteur de base de données ou l'édition RDS spécifié. Spécifiez un nombre valide de zones et réessayez.

    400

    InvalidSecurityIPList.Format

    The specified parameter securityIPList is not valid.

    Le message d'erreur renvoyé indique que la liste d'autorisation IP spécifiée est dans un format invalide. Modifiez la liste d'autorisation IP et réessayez.

    400

    InvalidEngineVersion.Malformed

    The specified parameter EngineVersion is not valid.

    Le message d'erreur renvoyé indique que la version du moteur de base de données spécifiée est invalide. Vérifiez la version du moteur de base de données et réessayez.

    400

    CreditPayInsufficientBalance

    Insufficient credit pay limit. Please contact your channel partner to increase the limit.

    Le message d'erreur renvoyé indique que votre compte Alibaba Cloud ne dispose pas d'un solde suffisant. Assurez-vous que le solde de votre compte Alibaba Cloud est suffisant.

    400

    InvalidTagKey.Malformed

    The Tag.N.Key parameter is empty.

    Le message d'erreur renvoyé indique que le paramètre Tag.N.Key est vide.

    400

    InvalidTagValue.Malformed

    The Tag.N.Value parameter is empty.

    Le message d'erreur renvoyé indique que le paramètre Tag.N.Value est vide.

    400

    Duplicate.TagKey

    The Tag.N.Key contains duplicate keys.

    Le message d'erreur renvoyé indique que le paramètre Tag.N.Key spécifie une clé en double.

    400

    NumberExceed.Tags

    The maximum number of Tags is exceeded. The maximum is 20.

    Le message d'erreur renvoyé indique que le nombre de tags que vous spécifiez dépasse le nombre maximal de tags autorisés. Un maximum de 20 tags est autorisé.

    400

    MissingParameter.ResourceIds

    The parameter ResourceIds.N must not be null.

    Le message d'erreur renvoyé indique que le paramètre ResourceIds.N est vide.

    400

    InvalidParameter.TagKey

    The Tag.N.Key parameter is invalid.

    Le message d'erreur renvoyé indique que la valeur du paramètre Tag.N.Key est invalide.

    400

    InvalidParameter.TagValue

    The Tag.N.Value parameter is invalid.

    Le message d'erreur renvoyé indique que le paramètre Tag.N.Value est invalide.

    400

    NoPermission.SystemTag

    You have no permission to use system tags.

    Le message d'erreur renvoyé indique que les tags que vous spécifiez sont des tags système.

    400

    InvalidParam.Amount

    Amount is allowed from 1 to 20.

    Le message d'erreur renvoyé indique que la valeur du paramètre Amount n'est pas comprise dans la plage de 1 à 20.

    400

    InvalidParam.CreateStrategy

    Only Atomicity and Partial are allowed.

    Le message d'erreur renvoyé indique que la valeur du paramètre CreateStrategy n'est pas Atomicity ou Partial.

    400

    InvalidConnectionString.Duplicate

    Specified connection string already exists in the Aliyun RDS.

    Le message d'erreur renvoyé indique que l'endpoint que vous avez spécifié existe déjà. Spécifiez un autre endpoint.

    401

    CannotDecreaseEssdPerfLevel

    cannot decrease cloud essd performance level.

    Le message d'erreur renvoyé indique que la modification du type de stockage a échoué à la vérification. Une instance exécutant SQL Server avec des SSD standard ou des ESSD ne peut être mise à niveau que pour utiliser des SSD standard ou des ESSD avec les nouvelles spécifications.

    403

    AliCroup2CloudUserCannotBuyNotInnerCommodity

    There is no group cloud commodity label, and users within the group are not allowed to purchase.

    Le message d'erreur renvoyé indique que les produits ne sont pas étiquetés avec Alibaba Cloud et ne sont pas disponibles pour les utilisateurs internes.

    403

    GroupReplicationNotSupport.InvalidEngineVersion

    Group Replication requires the instance engine version to be 8.0.

    Le message d'erreur renvoyé indique que la version majeure du moteur de l'instance n'est pas MySQL 8.0 et que la réplication de groupe n'est pas prise en charge.

    403

    GroupReplicationNotSupport.InvalidNodeClassCode

    Group Replication requires the ClassCode of each node to be consistent.

    Le message d'erreur renvoyé indique que les spécifications des nœuds de l'instance sont différentes et que la réplication de groupe n'est pas prise en charge.

    403

    GroupReplicationNotSupport.InvalidNodeNum

    Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.

    Le message d'erreur renvoyé indique que le nombre de nœuds de l'instance n'est pas un nombre impair supérieur à 3 et que la réplication de groupe n'est pas prise en charge.

    403

    GroupReplicationNotSupport.InvalidXengine

    Group Replication is not supported because the instance has xengine tables.

    Le message d'erreur renvoyé indique que des tables X-Engine existent dans l'instance et que la réplication de groupe n'est pas prise en charge.

    403

    GroupReplicationNotSupport.MemoryTooSmall

    Group Replication is not supported because the memory is too small.

    Le message d'erreur renvoyé indique que la capacité mémoire de l'instance est faible et que la réplication de groupe MySQL n'est pas prise en charge.

    403

    IncorrectMinorVersion

    Current engine minor version does not support operations.

    Le message d'erreur renvoyé indique que cette opération n'est pas prise en charge pour la version mineure actuelle du moteur.

    Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.