DescribeHistoryEvents - PolarDB: Central de Documentação do Alibaba Cloud

Lista os eventos históricos no Event Center.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:DescribeHistoryEvents

none

*DBCluster

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

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PageSize	integer	Não	O número de entradas por página. Valores válidos: 30 50 100	10
PageNumber	integer	Não	O número da página a ser consultada. O valor padrão é 1.	1
ArchiveStatus	string	Não	O status do evento. Valores válidos: Archived: O evento está arquivado. UnArchived: O evento não está arquivado. All: Todos os eventos.	All
EventCategory	string	Não	A categoria do evento do sistema. Valores válidos: Exception: atividade anômala Optimize: eventos de otimização Notification: eventos de notificação Maintenance: eventos de O&M agendados	Exception
EventType	string	Não	O tipo de evento do sistema. Este parâmetro é válido apenas quando InstanceEventType.N não é especificado. Valores válidos: SystemMaintenance.Reboot: A instância é reiniciada devido à manutenção do sistema. SystemMaintenance.Redeploy: A instância é reimplantada devido à manutenção do sistema. SystemFailure.Reboot: A instância é reiniciada devido a uma falha do sistema. SystemFailure.Redeploy: A instância é reimplantada devido a uma falha do sistema. SystemFailure.Delete: A instância é liberada porque não pôde ser criada. InstanceFailure.Reboot: A instância é reiniciada devido a uma falha da instância. InstanceExpiration.Stop: A instância por assinatura é interrompida porque sua assinatura expirou. InstanceExpiration.Delete: A instância por assinatura é liberada porque sua assinatura expirou. AccountUnbalanced.Stop: A instância pay-as-you-go é interrompida devido a um pagamento em atraso. AccountUnbalanced.Delete: A instância pay-as-you-go é liberada devido a um pagamento em atraso. Nota O valor deste parâmetro pode ser apenas um evento do sistema da instância, não um evento do sistema do disco.	SystemFailure.Reboot
EventLevel	string	Não	O nível do evento. Valores válidos: INFO: notificação WARN: aviso CRITICAL: crítico	high
EventStatus	string	Não	O status do evento. Valores válidos: Inquiring: o evento está sendo consultado. Scheduled: o evento está agendado. Running: o evento está em andamento. Succeed: o evento foi bem-sucedido. Failed: o evento falhou. Canceled: o evento foi cancelado. Nota Para consultar vários status, separe-os com vírgulas (,).	Succeed
ResourceType	string	Não	O tipo de recurso. Valores válidos: Instance: recurso de instância Host: recurso de host User: recurso de usuário	Instance
InstanceId	string	Não	O ID do recurso. Use este parâmetro para consultar tarefas de um recurso específico. Para consultar tarefas de vários recursos, separe os IDs dos recursos com vírgulas (,). Você pode especificar até 30 IDs de recursos. Se você deixar este parâmetro vazio, todos os recursos serão consultados. Nota Atualmente, apenas IDs de cluster são suportados.	pc-2zed3m89cw***
EventId	string	Não	O ID do evento.	5345398
TaskId	string	Não	O ID da tarefa agendada que você deseja cancelar. Nota Você pode chamar a operação DescribeScheduleTasks para visualizar informações sobre todas as tarefas agendadas na conta atual, incluindo os IDs das tarefas. Apenas tarefas que estão com execução pendente (o parâmetro Status retorna pending) podem ser canceladas.	32077515
FromStartTime	string	Não	O início do intervalo de tempo para consultar tarefas com base em sua hora de início. As tarefas que começaram após esse horário são consultadas. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Você pode consultar dados dos últimos 30 dias. Se a hora especificada for superior a 30 dias atrás, o sistema a define automaticamente para 30 dias atrás.	2025-01-02T11:31:03Z
ToStartTime	string	Não	O fim do intervalo de tempo para consultar tarefas com base em sua hora de início. As tarefas que começaram antes desse horário são consultadas. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.	2025-01-03T12:31:03Z
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-**********
RegionId	string	Não	O ID da região.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
PageNumber	integer	O número da página retornada. O valor padrão é 1.	1
RequestId	string	O ID da solicitação.	EB07CFF0-D8A4-5C76-AED7-D00E26FC2***
PageSize	integer	O número de entradas retornadas por página. Valores válidos: 30 50 100	30
TotalCount	integer	O número total de entradas na lista.	7
Items	array<object>	A lista de eventos.
	array<object>	A lista de eventos.
Id	string	O ID da tarefa.	123
Region	string	O ID da região onde a tarefa está localizada.	cn-hangzhou
Source	string	A origem do evento.	loanBill
Specversion	string	A versão do banco de dados.	8.0
Subject	string	O nome do evento pendente.	QiTian
Time	string	O tempo de execução da tarefa de consulta. Unidade: segundos (s).	1758680209206
Type	string	O tipo de evento.	host
Data	object	A visão geral dos dados.
EventType	string	The type of the system event. Valid values: SystemMaintenance.Reboot: The instance is restarted due to system maintenance. SystemMaintenance.Redeploy: The instance is redeployed due to system maintenance. SystemFailure.Reboot: The instance is restarted due to a system fault. SystemFailure.Redeploy: The instance is redeployed due to a system fault. SystemFailure.Delete: The instance is released because it failed to be created. InstanceFailure.Reboot: The instance is restarted due to an instance fault. InstanceExpiration.Stop: The subscription instance is stopped because its subscription expires. InstanceExpiration.Delete: The subscription instance is released because its subscription expires. AccountUnbalanced.Stop: The pay-as-you-go instance is stopped due to an overdue payment. AccountUnbalanced.Delete: The pay-as-you-go instance is released due to an overdue payment.	SystemFailure.Delete
EventId	string	The event ID.	600324
CmsProduct	string	The type of the Alibaba Cloud service for the application group. Valid values: web: web application. native: native application.	web
DbType	string	The database type.	mysql
DetailImpact	string	This parameter is used for pagination.	1
DetailReason	string	The details of the instance operation.	xxxx
EndTime	string	The end of the query time range. The end time must be later than the start time. The interval between the start time and the end time must be within 24 hours. The time is in the `YYYY-MM-DDThh:mmZ` format and is displayed in UTC.	2025-12-24T02:24:00Z
EventCategory	string	The category of the system event. Valid values: Exception: anomalous activity Optimize: optimization events Notification: notification events Maintenance: scheduled O&M events	Exception
EventCode	string	The event code.	de_aamexg3015
EventDetail	string	The event details.	xxxx
EventImpact	string	An overview of the event's impact.	xxxx
EventLevel	string	The event level. Valid values: INFO: notification WARN: warning CRITICAL: urgent	INFO
EventReason	string	The source of the event operation.	xxxxx
EventStatus	string	The event status. Valid values: Inquiring: The event is being inquired. Scheduled: The event is scheduled. Running: The event is in progress. Succeed: The event is successful. Failed: The event failed. Canceled: The event is canceled.	Inquiring
GmtCreated	string	The creation time.	2025-07-15T14:53:06+08:00
GmtModified	string	The update time.	2025-01-07T15:10:32+08:00
HandleStatus	string	The processing status.	done
HasLifeCycle	integer	Indicates whether a lifecycle exists.	false
InstanceId	string	The instance ID.	pc-2ze150h1p29t***
InstanceName	string	The instance name.	dhimgsearch
IsClosed	integer	Indicates whether the event is successfully closed. Valid values: 0: closed 1: open	1
Product	string	The product name.	polardb
RegionId	string	The region ID.	cn-beijing
ResourceType	string	The resource type. Valid values: Instance: instance resource Host: host resource User: user resource	Host
SourceType	string	The type of the source data.	loanBill
StartTime	string	The start of the query time range. The time is in the `yyyy-MM-ddTHH:mm:ssZ` format and is displayed in UTC.	2025-02-27T02:00:00Z
Uid	string	The ID of the user to whom the resource belongs.	1540497309282125

Exemplos

Resposta de sucesso

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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.