Todos os produtos
Search
Central de documentação

:DescribeAlertHistoryList

Última atualização: Jun 26, 2026

Consulta alertas históricos.

Esta operação de API não é mais mantida. Recomendamos chamar a operação DescribeAlertLogList.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeAlertHistoryList

A operação a ser executada. Defina o valor como DescribeAlertHistoryList.

RuleId String No applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****

O ID da regra de alerta.

Para saber como consultar o ID de uma regra de alerta, consulte DescribeMetricRuleList.

RuleName String No ECS_Rule

O nome da regra de alerta.

Para saber como consultar o nome de uma regra de alerta, consulte DescribeMetricRuleList.

Namespace String No acs_ecs_dashboard

O namespace do serviço de nuvem.

Para saber como consultar o namespace de um serviço de nuvem, consulte Appendix 1: Metrics.

MetricName String No cpu_total

A métrica usada para monitorar o serviço de nuvem.

Para saber como consultar o nome de uma métrica, consulte Appendix 1: Metrics.

GroupId String No 7671****

O ID do grupo de aplicações.

Para saber como obter o ID de um grupo de aplicações, consulte DescribeMonitorGroups.

Status String No 2

Indica se os alertas estão silenciados. Valores válidos:

  • 2 (padrão): Os alertas estão silenciados e não são disparados dentro do período de silêncio, mesmo que a condição especificada na regra de alerta seja atendida.
  • 0: Os alertas são disparados ou encerrados.
  • 1: A regra de alerta está inativa.
State String No ALARM

O status do alerta. Valores válidos:

  • ALARM (padrão): Os alertas são disparados.
  • OK: Nenhum alerta é disparado.
Ascending Boolean No true

A ordem de exibição dos alertas. Valores válidos:

  • true (padrão): ordem cronológica inversa
  • false: ordem cronológica
StartTime String No 1640237400000

O timestamp de início dos logs de alerta a serem consultados.

Unidade: milissegundos.

EndTime String No 1640608200000

O timestamp de término dos logs de alerta a serem consultados.

Unidade: milissegundos.

PageSize Integer No 10

O número de entradas retornadas por página.

Valor padrão: 10.

Page Integer No 1

O número da página retornada.

Valor padrão: 1.

Para mais informações sobre parâmetros comuns de requisição, consulte Parâmetros comuns.

Response parameters

Parameter Type Example Description
Code String 200

O código de status HTTP.

Nota O código de status 200 indica que a requisição foi bem-sucedida.
Message String The Request is not authorization.

A mensagem retornada.

RequestId String C3C69FBE-2262-541F-A409-C52F380BAE63

O ID da requisição.

Total String 2

O número total de entradas retornadas.

Success Boolean true

Indica se a requisição foi bem-sucedida. Valores válidos:

  • true
  • false
AlarmHistoryList Array of AlarmHistory

Os detalhes dos alertas históricos.

AlarmHistory
Status Integer 2

Indica se os alertas estão silenciados. Valores válidos:

  • 2 (padrão): Os alertas estão silenciados e não são disparados dentro do período de silêncio, mesmo que a condição especificada na regra de alerta seja atendida.
  • 0: Os alertas são disparados ou encerrados.
  • 1: A regra de alerta está inativa.
MetricName String cpu_total

O nome da métrica.

EvaluationCount Integer 3

O número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes de um alerta ser disparado.

State String ALARM

O status do alerta. Valores válidos:

  • ALARM: Os alertas são disparados.
  • OK: Nenhum alerta é disparado.
Namespace String acs_ecs_dashboard

O namespace do serviço de nuvem.

Webhooks String https://www.aliyun.com

A URL de callback.

RuleName String ECS_Rule

O nome da regra de alerta.

RuleId String applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****

O ID da regra de alerta.

LastTime Long 360133

A duração do alerta. Unidade: milissegundos.

Value String 10.58

O limiar do valor da métrica para disparar ou encerrar um alerta.

Expression String $Average>=10

A expressão usada para disparar alertas.

GroupId String 7671****

O ID do grupo de aplicações.

AlertTime Long 1640586600000

O timestamp em que o alerta foi disparado. Unidade: milissegundos.

InstanceName String i-bp1cqhiw1za2****

O nome da instância monitorada.

Dimensions String {\"instanceId\":\"i-bp1cqhiw1za2****\"}

Os recursos monitorados.

Level String P4

O nível de severidade e os métodos de notificação do alerta. Valores válidos:

  • P4: As notificações de alerta são enviadas por e-mail e por chatbots do DingTalk.
  • OK: Nenhum alerta é gerado.
Contacts Array of String Alice

Os contatos de alerta que recebem as notificações de alerta.

ContactALIIMs Array of String username@example.com

Os IDs do TradeManager dos contatos de alerta.

Nota Este parâmetro é válido apenas no site da China (aliyun.com).
ContactMails Array of String username@example.com

Os endereços de e-mail dos contatos de alerta.

ContactSmses Array of String 13900009999

Os números de celular dos contatos de alerta.

Nota Este parâmetro é válido apenas no site da China (aliyun.com).
ContactGroups Array of String ECS_Group

Os grupos de contatos de alerta.

Examples

Exemplos de requisições

http(s)://[Endpoint]/?Action=DescribeAlertHistoryList
&<Common request parameters>

Exemplos de respostas bem-sucedidas

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAlertHistoryListResponse>
	<AlarmHistoryList>
		<AlarmHistory>
			<Status>2</Status>
			<ContactGroups>
				<ContactGroup>ECS_Group</ContactGroup>
			</ContactGroups>
			<RuleId>applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****</RuleId>
			<Dimensions>{\"instanceId\":\"i-bp1cqhiw1za2****\"}</Dimensions>
			<EvaluationCount>3</EvaluationCount>
			<ContactMails></ContactMails>
			<ContactSmses></ContactSmses>
			<Namespace>acs_ecs_dashboard</Namespace>
			<AlertTime>1640586600000</AlertTime>
			<GroupId>7671****</GroupId>
			<InstanceName>i-bp1cqhiw1za2****</InstanceName>
			<MetricName>cpu_total</MetricName>
			<Contacts></Contacts>
			<Expression>$Average>=10</Expression>
			<State>ALARM</State>
			<Value>10.58</Value>
			<Level>P4</Level>
			<PreLevel>P4</PreLevel>
			<LastTime>360133</LastTime>
			<RuleName>ECS_Rule</RuleName>
			<ContactALIIMs></ContactALIIMs>
		</AlarmHistory>
		<AlarmHistory>
			<Status>0</Status>
			<ContactGroups>
				<ContactGroup>ECS_Group</ContactGroup>
			</ContactGroups>
			<RuleId>applyTemplate61dc81b5-d357-4cf6-a9b7-9f83****</RuleId>
			<Dimensions>{\"instanceId\":\"i-bp1cqhiw1za2807s****\"}</Dimensions>
			<EvaluationCount>3</EvaluationCount>
			<ContactMails></ContactMails>
			<ContactSmses></ContactSmses>
			<Namespace>acs_ecs_dashboard</Namespace>
			<AlertTime>1640586540000</AlertTime>
			<GroupId>7671****</GroupId>
			<InstanceName>i-bp1cqhiw1za2807s****</InstanceName>
			<MetricName>cpu_total</MetricName>
			<Contacts></Contacts>
			<Expression>$Average>=10</Expression>
			<State>ALARM</State>
			<Value>10.13</Value>
			<Level>P4</Level>
			<LastTime>300085</LastTime>
			<RuleName>ECS_Rule</RuleName>
			<ContactALIIMs>
				<ContactALIIM>\"username@example.com\"</ContactALIIM>
			</ContactALIIMs>
		</AlarmHistory>
	</AlarmHistoryList>
	<RequestId>C3C69FBE-2262-541F-A409-C52F380BAE63</RequestId>
	<Total>2</Total>
	<Code>200</Code>
	<Success>true</Success>
</DescribeAlertHistoryListResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "AlarmHistoryList" : {
    "AlarmHistory" : [ {
      "Status" : 2,
      "ContactGroups" : {
        "ContactGroup" : [ "ECS_Group" ]
      },
      "RuleId" : "applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****",
      "Dimensions" : "{\"instanceId\":\"i-bp1cqhiw1za2****\"}",
      "EvaluationCount" : 3,
      "ContactMails" : {
        "ContactMail" : [ ]
      },
      "ContactSmses" : {
        "ContactSms" : [ ]
      },
      "Namespace" : "acs_ecs_dashboard",
      "AlertTime" : 1640586600000,
      "GroupId" : "7671****",
      "InstanceName" : "i-bp1cqhiw1za2****",
      "MetricName" : "cpu_total",
      "Contacts" : {
        "Contact" : [ ]
      },
      "Expression" : "$Average>=10",
      "State" : "ALARM",
      "Value" : "10.58",
      "Level" : "P4",
      "PreLevel" : "P4",
      "LastTime" : 360133,
      "RuleName" : "ECS_Rule",
      "ContactALIIMs" : {
        "ContactALIIM" : [ ]
      }
    }, {
      "Status" : 0,
      "ContactGroups" : {
        "ContactGroup" : [ "ECS_Group" ]
      },
      "RuleId" : "applyTemplate61dc81b5-d357-4cf6-a9b7-9f83****",
      "Dimensions" : "{\"instanceId\":\"i-bp1cqhiw1za2807s****\"}",
      "EvaluationCount" : 3,
      "ContactMails" : {
        "ContactMail" : [ ]
      },
      "ContactSmses" : {
        "ContactSms" : [ ]
      },
      "Namespace" : "acs_ecs_dashboard",
      "AlertTime" : 1640586540000,
      "GroupId" : "7671****",
      "InstanceName" : "i-bp1cqhiw1za2807s****",
      "MetricName" : "cpu_total",
      "Contacts" : {
        "Contact" : [ ]
      },
      "Expression" : "$Average>=10",
      "State" : "ALARM",
      "Value" : "10.13",
      "Level" : "P4",
      "LastTime" : 300085,
      "RuleName" : "ECS_Rule",
      "ContactALIIMs" : {
        "ContactALIIM" : [ "\"username@example.com\"" ]
      }
    } ]
  },
  "RequestId" : "C3C69FBE-2262-541F-A409-C52F380BAE63",
  "Total" : 2,
  "Code" : "200",
  "Success" : true
}

Error codes

Para obter a lista de códigos de erro, consulte Códigos de erro do serviço.