Mettre à jour la version mineure du moteur - - Centre de documentation Alibaba Cloud

La mise à jour de la version mineure du moteur améliore les performances, ajoute des fonctionnalités et corrige les bugs connus. Pour plus d'informations, consultez les rubriques suivantes : Mettre à jour la version mineure du moteur d'une instance ApsaraDB RDS for MySQL, Mettre à jour la version mineure du moteur d'une instance ApsaraDB RDS for SQL Server et Mettre à jour la version mineure du moteur d'une instance ApsaraDB RDS for PostgreSQL.

Remarque

Cette opération n'est prise en charge que pour les instances exécutant les moteurs de base de données MySQL, SQL Server ou PostgreSQL.

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ètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	UpgradeDBInstanceKernelVersion	Nom de l'opération à effectuer. Définissez la valeur sur UpgradeDBInstanceKernelVersion.
DBInstanceId	String	Oui	rm-bpxxxxx	ID de l'instance. Ce paramètre n'est pris en charge que pour les instances exécutant les moteurs de base de données MySQL, PostgreSQL ou SQL Server. Remarque Si l'instance exécute PostgreSQL, assurez-vous qu'elle utilise des SSD standard ou des disques ESSD (Enhanced SSD). Si l'instance utilise des SSD locaux, appelez l'opération RestartDBInstance pour la redémarrer. ApsaraDB RDS mettra automatiquement à jour l'instance vers la dernière version mineure du moteur lors du redémarrage. Si l'instance exécute SQL Server, assurez-vous qu'il s'agit de SQL Server 2019.
UpgradeTime	String	Non	Immediate	Méthode de mise à jour de la version mineure du moteur. Valeurs possibles : Immediate : Mise à jour immédiate de la version mineure du moteur. MaintainTime : Mise à jour durant la fenêtre de maintenance spécifiée. Pour modifier la fenêtre de maintenance, consultez la rubrique ModifyDBInstanceMaintainTime. SpecifyTime : Mise à jour à l'instant spécifié. Valeur par défaut : Immediate.
SwitchTime	String	Non	2020-01-15T00:00:00Z	Instant précis de la mise à jour. Indiquez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC). Remarque Ce paramètre n'est effectif que si le paramètre UpgradeTime est défini sur SpecifyTime.
TargetMinorVersion	String	Non	xcluster80_20210305	Version mineure du moteur cible. Spécifiez-la selon l'un des formats suivants : PostgreSQL : `rds_postgres_<Version majeure du moteur>00_<Version mineure du moteur>`. Exemple : `rds_postgres_1200_20200830`. MySQL : `<Édition RDS>_<Version mineure du moteur>`. Exemples : `rds_20200229`, `xcluster_20200229` et `xcluster80_20200229`. Éditions RDS et versions MySQL prises en charge : rds : Instance exécutant RDS Basic Edition ou High-availability Edition. xcluster : Instance exécutant MySQL 5.7 sur RDS Enterprise Edition. xcluster80 : Instance exécutant MySQL 8.0 sur RDS Enterprise Edition. SQLServer : `<Version mineure du moteur>`. Exemple : `15.0.4073.23`. Si ce paramètre est omis, l'instance est mise à jour vers la dernière version mineure du moteur. Remarque Pour plus d'informations sur les versions mineures du moteur, consultez les rubriques Notes de publication des versions mineures AliPG, Notes de publication des versions mineures AliSQL et Notes de publication des versions mineures du moteur d'ApsaraDB RDS for SQL Server.

Paramètres de réponse

Paramètre	Type	Exemple	Description
DBInstanceName	String	rm-bpxxxxx	ID de l'instance.
RequestId	String	DA2ECBA0-4745-4491-9166-799FF8984AC9	ID de la requête.
TargetMinorVersion	String	xcluster80_20210305	Nouvelle version mineure du moteur de l'instance.
TaskId	String	226917711	ID de la tâche.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceKernelVersion
&DBInstanceId=rm-bpxxxxx
&UpgradeTime=SpecifyTime
&SwitchTime=2020-01-15T00:00:00Z
&TargetMinorVersion=xcluster80_20210305
&<Common request parameters>

Exemples de réponses réussies

Format XML

<UpgradeDBInstanceKernelVersion>
      <TaskId>226917711</TaskId>
      <RequestId>DA2ECBA0-4745-4491-9166-799FF8984AC9</RequestId>
      <TargetMinorVersion>xcluster80_20210305</TargetMinorVersion>
      <DBInstanceName>rm-bpxxxxx</DBInstanceName>
</UpgradeDBInstanceKernelVersion>

Format JSON

{
	"TaskId": "226917711",
	"RequestId": "DA2ECBA0-4745-4491-9166-799FF8984AC9",
	"TargetMinorVersion": "xcluster80_20210305",
	"DBInstanceName": "rm-bpxxxxx"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter.MinorVersionTag	You must specify the parameter MinorVersionTag.	La nouvelle version mineure du moteur de l'instance n'est pas spécifiée.
400	EngineNotSupported	The engine does not support the operation.	Le moteur de base de données de l'instance ne prend pas en charge cette opération.
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	L'instance est introuvable.
400	IncorrectDBInstanceState	The current instance state does not support this operation.	L'état actuel de l'instance ne permet pas d'effectuer cette opération.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Le mode de verrouillage de l'instance ne permet pas d'effectuer cette opération.
400	TaskExists	Specified task have existed.	La tâche spécifiée existe déjà.

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