Tous les produits
Search
Centre de documentation

:UpgradeDBInstanceEngineVersion

Dernière mise à jour :Aug 08, 2026

Met à niveau la version du moteur de base de données d'une instance ApsaraDB for MongoDB.

L'instance doit être en cours d'exécution lors de l'appel à cette opération.

Remarque
  • Les versions de base de données disponibles dépendent du moteur de stockage utilisé par l'instance. Pour plus d'informations, consultez la rubrique Mises à niveau des versions majeures de MongoDB. Vous pouvez également appeler l'opération DescribeAvailableEngineVersion pour récupérer les versions de base de données disponibles.

  • Il est impossible de revenir à une version antérieure de MongoDB après une mise à niveau.

  • L'instance redémarre automatiquement deux ou trois fois pendant le processus de mise à niveau. Effectuez cette opération pendant les heures creuses.

Débogage

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

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiUpgradeDBInstanceEngineVersion

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

RegionIdStringNoncn-hangzhou

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

DBInstanceIdStringOuidds-bpxxxxxxxx

ID de l'instance.

EngineVersionStringOui4.0

Version de base de données cible. Valeurs valides : 3.4, 4,0 et 4,2.

Remarque La version spécifiée doit être supérieure à la version actuelle de l'instance.

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String C4907B00-A208-4E0C-A636-AA85140E406C

ID de la requête.

Exemples

Exemple de requête

http(s)://mongodb.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&EngineVersion=4.0
&DBInstanceId=dds-bpxxxxxxxx
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
    <RequestId>C4907B00-A208-4E0C-A636-AA85140E406C</RequestId>
</UpgradeDBInstanceEngineVersionResponse>

Format JSON

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

{
  "RequestId" : "C4907B00-A208-4E0C-A636-AA85140E406C"
}

Codes d'erreur

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