Interroger le rapport de vérification préalable à la mise à niveau majeure d'une instance ApsaraDB RDS for PostgreSQL -

Avant de mettre à niveau la version majeure du moteur d'une instance ApsaraDB RDS for PostgreSQL, effectuez une vérification préalable et assurez-vous que le résultat est Success. Utilisez cette opération pour interroger le rapport de vérification de la mise à niveau.

Si le résultat de la vérification est Fail, corrigez les erreurs rencontrées. Pour plus d'informations sur la résolution des erreurs courantes, consultez la rubrique Présentation du rapport de vérification préalable à la mise à niveau majeure d'une instance ApsaraDB RDS for PostgreSQL.

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeUpgradeMajorVersionPrecheckTask	Nom de l'opération à effectuer. Définissez la valeur sur DescribeUpgradeMajorVersionPrecheckTask.
DBInstanceId	String	Yes	pgm-bp1c808s731l****	ID de l'instance.
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page dans le rapport de vérification de la mise à niveau. Valeurs valides : 30. Valeur par défaut. 50. 100.
PageNumber	Integer	No	1	Numéro de la page à renvoyer dans le rapport de vérification de la mise à niveau. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.
TargetMajorVersion	String	No	12.0	Nouvelle version majeure du moteur de l'instance. Cette version doit être ultérieure à la version majeure d'origine. Par exemple, si la version majeure d'origine est PostgreSQL 10.0, la nouvelle version majeure peut être PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15.
TaskId	Integer	No	416980000	ID de la tâche de vérification de la mise à niveau. Vous pouvez obtenir cet ID à partir du paramètre TaskId renvoyé par l'appel de l'opération UpgradeDBInstanceMajorVersionPrecheck.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	D1586777-41B5-5F9E-81E8-93DFDD379024	ID de la requête.
PageNumber	Integer	1	Numéro de la page renvoyée.
PageRecordCount	Integer	30	Nombre d'entrées renvoyées par page.
TotalRecordCount	Integer	1	Nombre total d'entrées dans le rapport de vérification de la mise à niveau.
Items	Array of Tasks		Tableau contenant les attributs du rapport de vérification de la mise à niveau.
TargetMajorVersion	String	12.0	Nouvelle version majeure du moteur de l'instance.
EffectiveTime	String	1635748703000	Date d'expiration du rapport de vérification de la mise à niveau. La valeur de ce paramètre est un horodatage au format UNIX. Unité : millisecondes.
SourceMajorVersion	String	11.0	Version majeure d'origine du moteur de l'instance.
Result	String	Success	Résultat de la vérification de la mise à niveau. Valeurs valides : Success Fail Remarque Si le résultat de la vérification est Fail, examinez la valeur du paramètre Detail pour obtenir des informations sur les erreurs survenues. Après avoir corrigé les erreurs, réessayez. Pour plus d'informations sur la résolution des erreurs courantes, consultez la rubrique Présentation du rapport de vérification préalable à la mise à niveau majeure d'une instance ApsaraDB RDS for PostgreSQL.
TaskId	Integer	416980000	ID de la tâche de vérification de la mise à niveau.
Detail	String	[user_check_report]User check success\n[pg_upgrade_internal.log]Performing...	Contenu du rapport de vérification de la mise à niveau.
CheckTime	String	1635143903000	Heure de la vérification de la mise à niveau. La valeur de ce paramètre est un horodatage au format UNIX. Unité : millisecondes.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

Format XML

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

<DescribeUpgradeMajorVersionPrecheckTask>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>D1586777-41B5-5F9E-81E8-93DFDD379024</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <CheckTime>1635143903000</CheckTime>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>416980000</TaskId>
        <EffectiveTime>1635748703000</EffectiveTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <Detail>[user_check_report]User check success\n[pg_upgrade_internal.log]Performing...</Detail>
        <Result>Success</Result>
    </Items>
</DescribeUpgradeMajorVersionPrecheckTask>

Format JSON

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 30,
  "RequestId" : "D1586777-41B5-5F9E-81E8-93DFDD379024",
  "PageNumber" : 1,
  "Items" : {
    "CheckTime" : 1635143903000,
    "SourceMajorVersion" : 11.0,
    "TaskId" : 416980000,
    "EffectiveTime" : 1635748703000,
    "TargetMajorVersion" : 12.0,
    "Detail" : "[user_check_report]User check success\\n[pg_upgrade_internal.log]Performing...",
    "Result" : "Success"
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	Le nom de l'instance spécifié est introuvable.

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