Todos los productos
Search
Centro de documentos

PolarDB:DescribeHistoryEvents

Última actualización: Sep 01, 2026

Lista los eventos históricos en el Centro de eventos.

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

none

*DBCluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#DbClusterId}

Ninguna Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

PageSize

integer

No

El número de entradas por página. Valores válidos:

  • 30

  • 50

  • 100

10

PageNumber

integer

No

El número de página a consultar. El valor predeterminado es 1.

1

ArchiveStatus

string

No

El estado del evento. Valores válidos:

  • Archived: el evento está archivado.

  • UnArchived: el evento no está archivado.

  • All: todos los eventos.

All

EventCategory

string

No

La categoría del evento del sistema. Valores válidos:

  • Exception: actividad anómala

  • Optimize: eventos de optimización

  • Notification: eventos de notificación

  • Maintenance: eventos programados de operación y mantenimiento (O&M)

Exception

EventType

string

No

El tipo de evento del sistema. Este parámetro es válido solo cuando no se especifica InstanceEventType.N. Valores válidos:

  • SystemMaintenance.Reboot: la instancia se reinicia debido a mantenimiento del sistema.

  • SystemMaintenance.Redeploy: la instancia se redespliega debido a mantenimiento del sistema.

  • SystemFailure.Reboot: la instancia se reinicia debido a un fallo del sistema.

  • SystemFailure.Redeploy: la instancia se redespliega debido a un fallo del sistema.

  • SystemFailure.Delete: la instancia se libera porque no se pudo crear.

  • InstanceFailure.Reboot: la instancia se reinicia debido a un fallo de la instancia.

  • InstanceExpiration.Stop: la instancia de suscripción se detiene porque su suscripción caducó.

  • InstanceExpiration.Delete: la instancia de suscripción se libera porque su suscripción caducó.

  • AccountUnbalanced.Stop: la instancia de pago por uso se detiene debido a un pago vencido.

  • AccountUnbalanced.Delete: la instancia de pago por uso se libera debido a un pago vencido.

Nota

El valor de este parámetro solo puede ser un evento del sistema de instancia, no un evento del sistema de disco.

SystemFailure.Reboot

EventLevel

string

No

El nivel del evento. Los valores válidos son:

  • INFO: notificación

  • WARN: advertencia

  • CRITICAL: crítico

high

EventStatus

string

No

El estado del evento. Valores válidos:

  • Inquiring: el evento está en consulta.

  • Scheduled: el evento está programado.

  • Running: el evento está en curso.

  • Succeed: el evento fue exitoso.

  • Failed: el evento falló.

  • Canceled: el evento fue cancelado.

Nota

Para consultar múltiples estados, sepárelos con comas (,).

Succeed

ResourceType

string

No

El tipo de recurso. Valores válidos:

  • Instance: recurso de instancia

  • Host: recurso de host

  • User: recurso de usuario

Instance

InstanceId

string

No

El ID del recurso. Utilice este parámetro para consultar tareas de un recurso específico. Para consultar tareas de varios recursos, separe los ID de recursos con comas (,). Puede especificar hasta 30 ID de recursos. Si deja este parámetro vacío, se consultan todos los recursos.

Nota

Actualmente, solo se admiten ID de clúster.

pc-2zed3m89cw***

EventId

string

No

El ID del evento.

5345398

TaskId

string

No

El ID de la tarea programada que desea cancelar.

Nota
  • Puede llamar a la operación DescribeScheduleTasks para ver información sobre todas las tareas programadas bajo la cuenta actual, incluidos los ID de las tareas.

  • Solo se pueden cancelar las tareas que están pendientes de ejecución (el parámetro Status devuelve pending).

32077515

FromStartTime

string

No

El inicio del intervalo de tiempo para consultar tareas según su hora de comienzo. Se consultan las tareas que comenzaron después de esta hora. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Puede consultar datos de los últimos 30 días. Si la hora especificada es anterior a hace 30 días, el sistema la establece automáticamente a hace 30 días.

2025-01-02T11:31:03Z

ToStartTime

string

No

El final del intervalo de tiempo para consultar tareas según su hora de comienzo. Se consultan las tareas que comenzaron antes de esta hora. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.

2025-01-03T12:31:03Z

ResourceGroupId

string

No

El ID del grupo de recursos.

rg-**********

RegionId

string

No

El ID de la región.

cn-hangzhou

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

PageNumber

integer

El número de página de la página devuelta. El valor predeterminado es 1.

1

RequestId

string

El ID de la solicitud.

EB07CFF0-D8A4-5C76-AED7-D00E26FC2***

PageSize

integer

El número de entradas devueltas por página. Valores válidos:

  • 30

  • 50

  • 100

30

TotalCount

integer

El número total de entradas en la lista.

7

Items

array<object>

La lista de eventos.

array<object>

La lista de eventos.

Id

string

El ID de la tarea.

123

Region

string

El ID de la región donde se encuentra la tarea.

cn-hangzhou

Source

string

El origen del evento.

loanBill

Specversion

string

La versión de la base de datos.

8.0

Subject

string

El nombre del evento pendiente.

QiTian

Time

string

El tiempo de ejecución de la tarea de consulta. Unidad: segundos (s).

1758680209206

Type

string

El tipo de evento.

host

Data

object

El resumen de datos.

EventType

string

El tipo de evento del sistema. Valores válidos:

  • SystemMaintenance.Reboot: La instancia se reinicia debido a mantenimiento del sistema.

  • SystemMaintenance.Redeploy: La instancia se redespliega debido a mantenimiento del sistema.

  • SystemFailure.Reboot: La instancia se reinicia debido a un fallo del sistema.

  • SystemFailure.Redeploy: La instancia se redespliega debido a un fallo del sistema.

  • SystemFailure.Delete: La instancia se libera porque no se pudo crear.

  • InstanceFailure.Reboot: La instancia se reinicia debido a un fallo de la instancia.

  • InstanceExpiration.Stop: La instancia de suscripción se detiene porque su suscripción caducó.

  • InstanceExpiration.Delete: La instancia de suscripción se libera porque su suscripción caducó.

  • AccountUnbalanced.Stop: La instancia de pago por uso se detiene debido a un pago vencido.

  • AccountUnbalanced.Delete: La instancia de pago por uso se libera debido a un pago vencido.

SystemFailure.Delete

EventId

string

El ID del evento.

600324

CmsProduct

string

El tipo de servicio de Alibaba Cloud para el grupo de aplicaciones. Valores válidos:

  • web: aplicación web.

  • native: aplicación nativa.

web

DbType

string

El tipo de base de datos.

mysql

DetailImpact

string

Este parámetro se utiliza para la paginación.

1

DetailReason

string

Los detalles de la operación de la instancia.

xxxx

EndTime

string

El final del intervalo de tiempo de consulta. La hora de finalización debe ser posterior a la hora de inicio. El intervalo entre la hora de inicio y la hora de finalización debe ser menor o igual a 24 horas. La hora tiene el formato YYYY-MM-DDThh:mmZ y se muestra en UTC.

2025-12-24T02:24:00Z

EventCategory

string

La categoría del evento del sistema. Valores válidos:

  • Exception: actividad anómala

  • Optimize: eventos de optimización

  • Notification: eventos de notificación

  • Maintenance: eventos programados de operación y mantenimiento (O&M)

Exception

EventCode

string

El código del evento.

de_aamexg3015

EventDetail

string

Los detalles del evento.

xxxx

EventImpact

string

Un resumen del impacto del evento.

xxxx

EventLevel

string

El nivel del evento. Valores válidos:

  • INFO: notificación

  • WARN: advertencia

  • CRITICAL: urgente

INFO

EventReason

string

El origen de la operación del evento.

xxxxx

EventStatus

string

El estado del evento. Valores válidos:

  • Inquiring: El evento está en consulta.

  • Scheduled: El evento está programado.

  • Running: El evento está en curso.

  • Succeed: El evento fue exitoso.

  • Failed: El evento falló.

  • Canceled: El evento fue cancelado.

Inquiring

GmtCreated

string

La hora de creación.

2025-07-15T14:53:06+08:00

GmtModified

string

La hora de actualización.

2025-01-07T15:10:32+08:00

HandleStatus

string

El estado de procesamiento.

done

HasLifeCycle

integer

Indica si existe un ciclo de vida.

false

InstanceId

string

El ID de la instancia.

pc-2ze150h1p29t***

InstanceName

string

El nombre de la instancia.

dhimgsearch

IsClosed

integer

Indica si el evento se cerró correctamente. Valores válidos:

  • 0: cerrado

  • 1: abierto

1

Product

string

El nombre del producto.

polardb

RegionId

string

El ID de la región.

cn-beijing

ResourceType

string

El tipo de recurso. Valores válidos:

  • Instance: recurso de instancia

  • Host: recurso de host

  • User: recurso de usuario

Host

SourceType

string

El tipo de datos de origen.

loanBill

StartTime

string

El inicio del intervalo de tiempo de consulta. La hora tiene el formato yyyy-MM-ddTHH:mm:ssZ y se muestra en UTC.

2025-02-27T02:00:00Z

Uid

string

El ID del usuario al que pertenece el recurso.

1540497309282125

Ejemplos

Respuesta exitosa

JSON Formato

{
  "PageNumber": 1,
  "RequestId": "EB07CFF0-D8A4-5C76-AED7-D00E26FC2***",
  "PageSize": 30,
  "TotalCount": 7,
  "Items": [
    {
      "Id": "123",
      "Region": "cn-hangzhou",
      "Source": "loanBill",
      "Specversion": "8.0",
      "Subject": "QiTian",
      "Time": "1758680209206",
      "Type": "host",
      "Data": {
        "EventType": "SystemFailure.Delete",
        "EventId": "600324",
        "CmsProduct": "web",
        "DbType": "mysql",
        "DetailImpact": "1",
        "DetailReason": "xxxx",
        "EndTime": "2025-12-24T02:24:00Z",
        "EventCategory": "Exception",
        "EventCode": "de_aamexg3015",
        "EventDetail": "xxxx",
        "EventImpact": "xxxx",
        "EventLevel": "INFO",
        "EventReason": "xxxxx",
        "EventStatus": "Inquiring",
        "GmtCreated": "2025-07-15T14:53:06+08:00",
        "GmtModified": "2025-01-07T15:10:32+08:00",
        "HandleStatus": "done",
        "HasLifeCycle": 0,
        "InstanceId": "pc-2ze150h1p29t***",
        "InstanceName": "dhimgsearch",
        "IsClosed": 1,
        "Product": "polardb",
        "RegionId": "cn-beijing",
        "ResourceType": "Host",
        "SourceType": "loanBill",
        "StartTime": "2025-02-27T02:00:00Z",
        "Uid": "1540497309282125"
      }
    }
  ]
}

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.