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

Consulta la información sobre un evento pendiente.

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:DescribePendingMaintenanceAction

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Region	string	Sí	El ID de región del evento pendiente. Puede llamar a la operación DescribeRegions para consultar las regiones y zonas compatibles con PolarDB. Nota Puede establecer este parámetro en all para ver todos los eventos pendientes dentro de su cuenta. Si establece `Region` en all, debe establecer `TaskType` en all.	all
TaskType	string	Sí	El tipo de tarea de los eventos pendientes. Valores válidos: DatabaseSoftwareUpgrading: actualizaciones de software de base de datos DatabaseHardwareMaintenance: mantenimiento y actualizaciones de hardware DatabaseStorageUpgrading: actualizaciones de almacenamiento de base de datos DatabaseProxyUpgrading: actualizaciones de versión menor del proxy all: devuelve eventos pendientes de todos los tipos anteriores. Nota Si el parámetro `Region` se establece en all, el parámetro `TaskType` debe establecerse en all.	all
IsHistory	integer	No	Especifica si se deben devolver las tareas históricas. Valores válidos: 0: devuelve la tarea actual. 1: devuelve las tareas históricas. Valor predeterminado: 0.	0
PageSize	integer	No	El número de entradas por página. Valores válidos: 30, 50 y 100. Valor predeterminado: 30.	30
PageNumber	integer	No	El número de la página a devolver. Especifique el parámetro como un entero positivo que no exceda el valor máximo del tipo de datos INTEGER. Valor predeterminado: 1.	1
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-************

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
TotalRecordCount	integer	El número total de entradas devueltas.	1
RequestId	string	El ID de la solicitud.	2F029645-FED9-4FE8-A6D3-488954******
PageSize	integer	El número de entradas por página.	30
PageNumber	integer	El número de página.	1
Items	array<object>	Detalles sobre las tareas.
	object
Status	integer	El estado de la tarea pendiente. Si establece el parámetro `IsHistory` en 0, se devuelve el estado de la tarea pendiente. Valores válidos: 2: La hora de inicio de la tarea está por especificarse. 3: La tarea está pendiente. 4: La tarea se está ejecutando. En este caso, no puede modificar la hora de ejecución. Si establece el parámetro `IsHistory` en 1, se devuelven los detalles de las tareas históricas. Valores válidos: 5: La tarea se completó y se ejecutó correctamente. 6: La tarea se completó pero falló su ejecución. 7: La tarea se canceló.	3
PrepareInterval	string	El tiempo de preparación requerido antes de que se realice el cambio del evento pendiente. La hora sigue el formato `HH:mm:ss`.	04:00:00
Deadline	string	La fecha límite antes de la cual se puede ejecutar la tarea. La hora tiene el formato `yyyy-MM-ddTHH:mm:ssZ`. La hora se muestra en UTC.	2020-06-11T15:59:59Z
DBType	string	El tipo de motor de base de datos. Valores válidos: MySQL PostgreSQL Oracle	MySQL
TaskType	string	El tipo de evento pendiente.	DatabaseSoftwareUpgrading
StartTime	string	La hora en que se ejecutó la tarea en segundo plano. La hora tiene el formato `yyyy-MM-ddTHH:mm:ssZ`. La hora se muestra en UTC.	2020-06-09T18:00:00Z
DBVersion	string	La versión del motor de base de datos. Valores válidos para el motor de base de datos MySQL: 5.6 5.7 8.0 Valores válidos para el motor de base de datos PostgreSQL: 11 14 Valor válido para el motor de base de datos Oracle: 11	8.0
ModifiedTime	string	La hora en que se modificó el parámetro. La hora tiene el formato `yyyy-MM-ddTHH:mm:ssZ`. La hora se muestra en UTC.	2020-06-09T22:00:42Z
DBClusterId	string	El ID del clúster.	pc-************
Region	string	El ID de región del evento pendiente.	cn-hangzhou
ResultInfo	string	El resultado de ejecución de la tarea. Valores válidos: manualCancel: La tarea se canceló manualmente. paramCheckNotPass: La tarea no pasó la verificación de parámetros. Nota Este parámetro se devuelve solo cuando el valor del parámetro `Status` es 6 o 7. El valor 6 indica que la tarea se completó pero falló su ejecución. El valor 7 indica que la tarea se canceló.	manualCancel
CreatedTime	string	La hora en que se creó la tarea. La hora tiene el formato `yyyy-MM-ddTHH:mm:ssZ`. La hora se muestra en UTC.	2020-06-09T22:00:42Z
Id	integer	El ID de la tarea.	111111
SwitchTime	string	La hora en que se realizó el cambio del evento pendiente. La hora tiene el formato `yyyy-MM-ddTHH:mm:ssZ`. La hora se muestra en UTC.	2020-06-09T22:00:00Z

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalRecordCount": 1,
  "RequestId": "2F029645-FED9-4FE8-A6D3-488954******",
  "PageSize": 30,
  "PageNumber": 1,
  "Items": [
    {
      "Status": 3,
      "PrepareInterval": "04:00:00",
      "Deadline": "2020-06-11T15:59:59Z",
      "DBType": "MySQL",
      "TaskType": "DatabaseSoftwareUpgrading",
      "StartTime": "2020-06-09T18:00:00Z",
      "DBVersion": "8.0",
      "ModifiedTime": "2020-06-09T22:00:42Z",
      "DBClusterId": "pc-************",
      "Region": "cn-hangzhou",
      "ResultInfo": "manualCancel",
      "CreatedTime": "2020-06-09T22:00:42Z",
      "Id": 111111,
      "SwitchTime": "2020-06-09T22:00:00Z"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	RequiredParam.NotFound	Required input param is not found.

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.