Vérifier la compatibilité d'une nouvelle version majeure du moteur avec une instance ApsaraDB RDS for PostgreSQL avant une mise à niveau -

ApsaraDB RDS for PostgreSQL propose une fonctionnalité de mise à niveau des versions majeures du moteur. Cette fonctionnalité vous permet de mettre à jour la version majeure du moteur d'une instance ApsaraDB RDS for PostgreSQL.

Avant la mise à niveau, effectuez une vérification préalable et assurez-vous que le résultat est Succès. Appelez cette opération pour réaliser ce contrôle.

Une mise à niveau entraîne des impacts, tels qu'une interruption temporaire de la connexion durant quelques minutes. Nous vous recommandons d'effectuer cette opération pendant les heures creuses. Avant de procéder, consultez la rubrique Mettre à niveau la version majeure du moteur d'une instance ApsaraDB RDS for PostgreSQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement un exemple de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	UpgradeDBInstanceMajorVersionPrecheck	Action à exécuter. Définissez la valeur sur UpgradeDBInstanceMajorVersionPrecheck.
DBInstanceId	String	Oui	pgm-bp1c808s731l****	ID de l'instance. L'instance doit satisfaire les exigences suivantes : L'instance exécute PostgreSQL 14, PostgreSQL 13, PostgreSQL 12, PostgreSQL 11, PostgreSQL 10 ou PostgreSQL 9.4. L'instance fonctionne avec l'édition Haute disponibilité (High-availability Edition) ou l'édition Basique (Basic Edition) de RDS. L'instance RDS doit résider dans un réseau privé virtuel (VPC). Si l'instance d'origine se trouve dans le réseau classique, migrez-la vers un VPC avant d'appeler cette opération. Pour savoir comment afficher ou modifier le type de réseau d'une instance, consultez la page Modifier le type de réseau d'une instance ApsaraDB RDS for PostgreSQL. L'instance ne doit pas être une instance en lecture seule ni avoir été créée dans un cluster dédié.
TargetMajorVersion	String	Oui	12.0	Nouvelle version majeure du moteur de l'instance. La version cible doit être ultérieure à la version d'origine. Par exemple, si la version majeure actuelle est PostgreSQL 10, la nouvelle version peut être PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15.

Paramètres de réponse

Paramètre	Type	Exemple	Description
DBInstanceName	String	pgm-bp1c808s731l****	Nom de l'instance.
TargetMajorVersion	String	12.0	Nouvelle version majeure du moteur de l'instance.
RequestId	String	99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4	ID de la requête.
TaskId	String	41698****	ID de la tâche.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceMajorVersionPrecheck
&DBInstanceId=pgm-bp1c808s731l****
&TargetMajorVersion=12.0
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

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

<UpgradeDBInstanceMajorVersionPrecheck>
    <TaskId>41698****</TaskId>
    <RequestId>99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4</RequestId>
    <TargetMajorVersion>12.0</TargetMajorVersion>
    <DBInstanceName>pgm-bp1c808s731l****</DBInstanceName>
</UpgradeDBInstanceMajorVersionPrecheck>

JSON format

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

{
  "TaskId" : "41698****",
  "RequestId" : "99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4",
  "TargetMajorVersion" : 12.0,
  "DBInstanceName" : "pgm-bp1c808s731l****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	Le nom de l'instance spécifiée est introuvable.
400	InvalidDBInstanceEngineType.Format	the DB instance engine type does not support this operation.	Le moteur de base de données de l'instance ne prend pas en charge cette opération.
403	ParamNotFound	The parameter is not found for the interface.	Le paramètre requis est introuvable.

Pour consulter la liste des codes d'erreur, rendez-vous sur la page Codes d'erreur du service.