DescribeUpgradeReport - PolarDB - Centro de documentación de Alibaba Cloud

Consulta un informe de verificación de actualización o migración.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:DescribeUpgradeReport

get

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	No	El ID de la región. Nota Puede llamar a la operación DescribeRegions para consultar las regiones disponibles.	cn-hangzhou
SourceDBClusterId	string	No	El ID de la instancia de origen.	rm-2zen5pe5vi56447d0
DBType	string	No	El tipo de base de datos. Valores válidos: MySQL. Oracle.	MySQL
DBVersion	string	No	La versión de base de datos compatible.	8.0
TaskId	string	No	El ID de la tarea.	2321321
PageNumber	integer	No	El número de página.	1
PageSize	integer	No	El número de entradas por página.	30
Status	string	No	El estado de la tarea.	Running
Type	string	No	La métrica especial. Actualmente, solo se admite tair (arquitectura PolarTair).	orca
CreationCategory	string	No	La edición. Valores válidos: Normal: Edición de clúster (predeterminada). SENormal: Edición estándar. Para obtener más información sobre las ediciones, consulte Ediciones del producto.	Normal

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	2FED790E-FB61-4721-8C1C-07C627******
SourceDBClusterId	string	El ID de la instancia de origen.	rm-2zen5pe5vi56447d0
TotalSize	integer	El número total de entradas en el resultado de la consulta.	137
UpgradeReportList	array<object>	La lista de informes de evaluación.
	object
TaskId	string	El ID de la tarea de destino.	275948
CheckTime	string	La hora de verificación. La hora está en el estándar ISO 8601 en la zona horaria UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2024-03-15T06:48:44Z
DstVersion	string	La versión de la instancia de destino.	8.0
SrcInsName	string	El nombre de la instancia de origen.	pc-2ze54671qoz830za9
SrcVersion	string	La versión de la instancia de origen.	5.7
UpgradeMode	string	El modo de actualización.	rds2polar_pengine_with_dts
Result	string	El estado de la tarea de evaluación.	running
EffectiveTime	string	El periodo de validez de la evaluación. La hora está en el estándar ISO 8601 en la zona horaria UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2024-03-08T06:48:44Z
StartTime	string	La hora de inicio de la evaluación. La hora está en el estándar ISO 8601 en la zona horaria UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2025-07-05T01:56:00Z
EndTime	string	La hora de finalización de la evaluación. La hora está en el estándar ISO 8601 en la zona horaria UTC (formato: YYYY-MM-DDTHH:mm:ssZ).	2024-03-08T06:48:44Z
ItemsSize	integer	La longitud de la lista de detalles de la evaluación de compatibilidad de Oracle.	10
Items	array<object>	La lista de detalles de la evaluación de compatibilidad de Oracle. Nota Solo se admiten las instancias de Oracle.
	object	La lista.
Schema	string	El esquema al que pertenece el objeto evaluado.	ny_openapi
Type	string	El tipo del objeto evaluado.	orca
Name	string	El nombre del objeto evaluado.	testName
Status	string	El resultado de la evaluación de compatibilidad. Valores válidos: 0: Error. 1: Éxito.	1
DDL	string	La instrucción DDL para la sincronización de objetos.	CREATE XXXX
Details	string	Los detalles.	[]
SrcDBType	string	El tipo de base de datos de la instancia de origen. Valores válidos: MySQL. Oracle.	MySQL
DstDBType	string	El tipo de base de datos de la instancia de destino. Valores válidos: MySQL. Oracle.	MySQL
SrcDeleted	string	El estado de eliminación de la instancia de origen. Valores válidos: 0: No eliminada. 1: Eliminada.	1
Type	string	La métrica especial. Actualmente, solo se admite tair (arquitectura PolarTair).	tair

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "2FED790E-FB61-4721-8C1C-07C627******",
  "SourceDBClusterId": "rm-2zen5pe5vi56447d0",
  "TotalSize": 137,
  "UpgradeReportList": [
    {
      "TaskId": "275948",
      "CheckTime": "2024-03-15T06:48:44Z",
      "DstVersion": "8.0",
      "SrcInsName": "pc-2ze54671qoz830za9",
      "SrcVersion": "5.7",
      "UpgradeMode": "rds2polar_pengine_with_dts",
      "Result": "running",
      "EffectiveTime": "2024-03-08T06:48:44Z",
      "StartTime": "2025-07-05T01:56:00Z",
      "EndTime": "2024-03-08T06:48:44Z"
    }
  ],
  "ItemsSize": 10,
  "Items": [
    {
      "Schema": "ny_openapi",
      "Type": "orca",
      "Name": "testName",
      "Status": "1",
      "DDL": "CREATE XXXX"
    }
  ],
  "Details": "[]",
  "SrcDBType": "MySQL",
  "DstDBType": "MySQL",
  "SrcDeleted": "1",
  "Type": "tair"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.