Tous les produits
Search

Ce produit

    :CreateDBInstance

    Centre de documentation

    :CreateDBInstance

    Dernière mise à jour :Aug 08, 2026

    Crée ou clone une instance de jeu de réplicas ApsaraDB for MongoDB.

    Avant d'appeler cette opération, assurez-vous de bien comprendre les modes de facturation ainsi que la tarification.

    Pour plus d'informations sur les types d'instances ApsaraDB for MongoDB, consultez la rubrique Types d'instances.

    Pour créer des instances en cluster fragmenté, utilisez l'opération CreateShardingDBInstance.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement un exemple de code pour différents SDK.

    Paramètres de requête

    ParamètreTypeObligatoireExempleDescription
    ActionStringOuiCreateDBInstance

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

    RegionIdStringOuicn-hangzhou

    ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions disponibles.

    ClientTokenStringNonETnLKlblzczshOTUbOCz****

    Jeton client utilisé pour garantir l'idempotence de la requête. Générez cette valeur à partir du client en veillant à son unicité pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères.

    ZoneIdStringNoncn-hangzhou-g

    ID de zone de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des zones disponibles.

    EngineStringOuiMongoDB

    Moteur de base de données de l'instance. La valeur est définie sur MongoDB.

    EngineVersionStringOui4.4

    Version du moteur de l'instance. Valeurs possibles :

    • 6.0
    • 5.0
    • 4.4
    • 4.2
    • 4.0
    Remarque Lorsque vous clonez une instance via cette opération, spécifiez la version du moteur de l'instance source.
    DBInstanceClassStringOuidds.mongo.standard

    Type d'instance. Appelez également l'opération DescribeAvailableResource pour afficher les types d'instances disponibles.

    DBInstanceStorageIntegerOui10

    Capacité de stockage de l'instance. Unité : Go.

    Les valeurs acceptées pour ce paramètre dépendent du type d'instance. Pour plus de détails, consultez la rubrique Types d'instances de jeux de réplicas.

    DBInstanceDescriptionStringNontest

    Nom de l'instance. Règles de nommage :

    • Le nom doit commencer par une lettre.
    • Le nom peut contenir des chiffres, des lettres, des traits de soulignement (_) et des tirets (-).
    • La longueur du nom doit être comprise entre 2 et 256 caractères.
    SecurityIPListStringNon192.168.xx.xx,192.168.xx.xx

    Adresses IP incluses dans la liste blanche. Séparez plusieurs adresses par des virgules (,). Chaque adresse IP doit être unique. Les formats suivants sont pris en charge :

    • 0.0.0.0/0
    • Adresses IP, par exemple 10.23.12.24.
    • Plages CIDR, par exemple 10.23.12.0/24. Dans cet exemple, /24 indique que le préfixe de chaque adresse IP est de 24 bits. Vous pouvez remplacer 24 par une valeur comprise entre 1 et 32.
      Remarque
      • Vous pouvez configurer jusqu'à 1 000 adresses IP et plages CIDR par instance.
      • Si vous saisissez 0.0.0.0/0, toutes les adresses IP peuvent accéder à l'instance. Cette configuration présente des risques de sécurité.
    AccountPasswordStringNon123456Aa

    Mot de passe du compte root. Il doit respecter les règles suivantes :

    • Il doit contenir au moins trois des types de caractères suivants : majuscules, minuscules, chiffres et caractères spéciaux.
    • Les caractères spéciaux autorisés sont ! # $ % ^ & * ( ) _ + - =
    • Sa longueur doit être comprise entre 8 et 32 caractères.
    ChargeTypeStringNonPrePaid

    Mode de facturation de l'instance. Valeurs possibles :

    • PostPaid : paiement à l'utilisation
    • PrePaid : abonnement
    Remarque Si vous définissez ce paramètre sur PrePaid, vous devez également spécifier le paramètre Period.
    PeriodIntegerNon1

    Durée de l'abonnement. Unité : mois.

    Valeurs valides : 1 à 9, 12, 24, 36 et 60.

    Remarque Ce paramètre est obligatoire si la propriété ChargeType est définie sur PrePaid.
    NetworkTypeStringNonVPC

    Type de réseau de l'instance. Valeur possible :

    VPC

    VpcIdStringOuivpc-bp175iuvg8nxqraf2****

    ID du VPC de l'instance.

    VSwitchIdStringOuivsw-bp1gzt31twhlo0sa5****

    ID du vSwitch de l'instance.

    SrcDBInstanceIdStringNondds-bp1ee12ad351****

    ID de l'instance source.

    Remarque Ce paramètre est uniquement requis lors du clonage d'une instance. Vous devez également spécifier le paramètre BackupId ou le paramètre RestoreTime.
    BackupIdStringNon32994****

    ID de l'ensemble de sauvegarde. Appelez l'opération DescribeBackups pour obtenir l'ID.

    Remarque Ce paramètre est obligatoire uniquement lors du clonage d'une instance. Si vous le spécifiez, vous devez également indiquer le paramètre SrcDBInstanceId.
    RestoreTimeStringNon2022-03-13T12:11:14Z

    Horodatage de restauration de l'instance clonée. La date doit se situer dans les sept derniers jours. Utilisez le format yyyy-MM-ddTHH:mm:ssZ (heure UTC).

    Remarque Ce paramètre est obligatoire uniquement lors du clonage d'une instance. Si vous le spécifiez, vous devez également indiquer le paramètre SrcDBInstanceId.
    BusinessInfoStringNon{“ActivityId":"000000000"}

    Informations commerciales. Il s'agit d'un paramètre supplémentaire.

    AutoRenewStringNontrue

    Indique si le renouvellement automatique est activé pour l'instance. Valeur par défaut : false. Valeurs possibles :

    • true
    • false
    Remarque Si le paramètre ChargeType est défini sur PrePaid, ce paramètre facultatif devient obligatoire.
    DatabaseNamesStringNonmongodbtest

    Nom de la base de données.

    Remarque Lors du clonage d'une instance, vous pouvez limiter l'opération aux bases de données spécifiées par ce paramètre. À défaut, toutes les bases de données de l'instance seront clonées.
    CouponNoStringNonyouhuiquan_promotion_option_id_for_blank

    Code du coupon. Valeur par défaut : youhuiquan_promotion_option_id_for_blank.

    StorageEngineStringNonWiredTiger

    Moteur de stockage de l'instance. Valeur par défaut : WiredTiger.

    Remarque
    • Lors du clonage d'une instance, spécifiez le moteur de l'instance source.
    • Pour connaître les limites liées aux versions de base de données et aux moteurs de stockage, consultez la rubrique Versions MongoDB et moteurs de stockage.
    ReplicationFactorStringNon3

    Nombre de nœuds dans l'instance de jeu de réplicas. Valeur par défaut : 3. Valeurs possibles :

    • 3
    • 5
    • 7
    ReadonlyReplicasStringNon0

    Nombre de nœuds en lecture seule dans l'instance de jeu de réplicas. Valeur par défaut : 0. Valeurs possibles : 0 à 5.

    StorageTypeStringNoncloud_essd

    Type de stockage de l'instance. Valeurs possibles :

    • cloud_essd : disque ESSD amélioré
    • local_ssd : disque SSD local

    Paramètres de réponse

    Paramètre Type Exemple Description
    RequestId String D8F1D721-6439-4257-A89C-F1E8E9C9****

    ID de la requête.
    DBInstanceId String dds-bp144a7f2db8****

    ID de l'instance.
    OrderId String 21077576248****

    ID de la commande.

    Exemples

    Exemple de requête

    http(s)://mongodb.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&ClientToken=ETnLKlblzczshOTUbOCz****
&ZoneId=cn-hangzhou-g
&Engine=MongoDB
&EngineVersion=4.4
&DBInstanceClass=dds.mongo.standard
&DBInstanceStorage=10
&DBInstanceDescription=test
&SecurityIPList=192.168.xx.xx,192.168.xx.xx
&AccountPassword=123456Aa
&ChargeType=PrePaid
&Period=1
&NetworkType=VPC
&VpcId=vpc-bp175iuvg8nxqraf2****
&VSwitchId=vsw-bp1gzt31twhlo0sa5****
&BusinessInfo={“ActivityId":"000000000"}
&AutoRenew=true
&CouponNo=youhuiquan_promotion_option_id_for_blank
&StorageEngine=WiredTiger
&ReplicationFactor=3
&ReadonlyReplicas=0
&StorageType=cloud_essd
&SecondaryZoneId=cn-hangzhou-h
&HiddenZoneId=cn-hangzhou-i
&Common request parameters

    Exemple de réponse réussie

    Format XML

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

<CreateDBInstanceResponse>
    <RequestId>D8F1D721-6439-4257-A89C-F1E8E9C9****</RequestId>
    <DBInstanceId>dds-bp144a7f2db8****</DBInstanceId>
    <OrderId>21077576248****</OrderId>
</CreateDBInstanceResponse>

    Format JSON

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

{
  "RequestId" : "D8F1D721-6439-4257-A89C-F1E8E9C9****",
  "DBInstanceId" : "dds-bp144a7f2db8****",
  "OrderId" : "21077576248****"
}

    Codes d'erreur

    Code d'état HTTP Code d'erreur Message d'erreur Description
    400 InvalidDBInstanceDescription.Malformed Specified parameter DBInstanceDescription is not valid. Le nom du nœud spécifié n'est pas valide.
    400 InsufficientBalance Your account does not have enough balance. Échec du paiement. Ajoutez un autre mode de paiement ou approvisionnez votre compte, puis réessayez.
    400 InvalidCapacity.NotFound The Capacity provided does not exist in our records. L'espace de stockage spécifié pour l'instance n'est pas valide. Indiquez une valeur comprise dans la plage autorisée. Unité : Mo.
    400 IdempotentParameterMismatch Request uses a client token in a previous request but is not identical to that request. Le paramètre ClientToken spécifié a déjà été utilisé. Indiquez une valeur unique qui n'a pas encore servi. Générez cette valeur à partir du client en veillant à son unicité pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères.
    403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. La vérification d'identité réelle de votre compte Alibaba Cloud n'est pas terminée. Effectuez la vérification, puis réessayez.
    403 IncorrectBackupSetState Current backup set state does not support operations. Le dernier ensemble de sauvegarde n'est pas prêt. Réessayez ultérieurement.

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