Consulta del informe de verificación para una actualización de versión principal del motor en una instancia de ApsaraDB RDS for PostgreSQL -

Puede llamar a la operación DescribeUpgradeMajorVersionPrecheckTask para consultar el informe de verificación correspondiente a una actualización de versión principal del motor en una instancia de ApsaraDB RDS for PostgreSQL.

Antes de actualizar la versión principal del motor de una instancia de ApsaraDB RDS for PostgreSQL, debe ejecutar una verificación de actualización y asegurarse de que el resultado sea Success. Puede llamar a esta operación para consultar el informe de verificación de la actualización.

Si el resultado de la verificación es Fail, debe resolver los errores que se hayan producido. Para obtener más información sobre cómo solucionar los errores comunes, consulte Introducción al informe de verificación para una actualización de versión principal del motor en una instancia de ApsaraDB RDS for PostgreSQL.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeUpgradeMajorVersionPrecheckTask	La operación que desea ejecutar. Establezca el valor en DescribeUpgradeMajorVersionPrecheckTask.
DBInstanceId	String	Sí	pgm-bp1c808s731l****	El ID de la instancia.
PageSize	Integer	No	30	El número de entradas por página en el informe de verificación de la actualización. Valores válidos: 30 (valor predeterminado). 50. 100.
PageNumber	Integer	No	1	El número de página del informe de verificación de la actualización. Valores válidos: cualquier entero positivo distinto de cero. Valor predeterminado: 1.
TargetMajorVersion	String	No	12.0	La nueva versión principal del motor de la instancia. Debe ser posterior a la versión principal original. Por ejemplo, si la versión principal original del motor es PostgreSQL 10.0, la nueva versión puede ser PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 o PostgreSQL 15.
TaskId	Integer	No	416980000	El ID de la tarea de verificación de la actualización. Puede obtener este ID mediante el parámetro TaskId que devuelve la operación UpgradeDBInstanceMajorVersionPrecheck.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	D1586777-41B5-5F9E-81E8-93DFDD379024	El ID de la solicitud.
PageNumber	Integer	1	El número de la página devuelta.
PageRecordCount	Integer	30	El número de entradas devueltas por página.
TotalRecordCount	Integer	1	El número total de entradas en el informe de verificación de la actualización.
Items	Array of Tasks		Una matriz que contiene los atributos del informe de verificación de la actualización.
TargetMajorVersion	String	12.0	La nueva versión principal del motor de la instancia.
EffectiveTime	String	1635748703000	La fecha de caducidad del informe de verificación de la actualización. El valor de este parámetro es una marca de tiempo en formato UNIX. Unidad: milisegundos.
SourceMajorVersion	String	11.0	La versión principal original del motor de la instancia.
Result	String	Success	El resultado de la verificación de la actualización. Valores válidos: Success Fail Nota Si el resultado de la verificación es Fail, revise el valor del parámetro Detail para obtener información sobre los errores ocurridos. Una vez resueltos los errores, puede intentarlo de nuevo. Para obtener más información sobre cómo solucionar los errores comunes, consulte Introducción al informe de verificación para una actualización de versión principal del motor en una instancia de ApsaraDB RDS for PostgreSQL.
TaskId	Integer	416980000	El ID de la tarea de verificación de la actualización.
Detail	String	[user_check_report]User check success\n[pg_upgrade_internal.log]Performing...	El contenido del informe de verificación de la actualización.
CheckTime	String	1635143903000	La hora en la que se ejecutó la verificación de la actualización. El valor de este parámetro es una marca de tiempo en formato UNIX. Unidad: milisegundos.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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"
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	El mensaje de error indica que no se encuentra el nombre de la instancia.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.