Todos os produtos
Search
Central de documentação

:DescribeActiveMetricRuleList

Última atualização: Jun 26, 2026

Consulta os detalhes das regras de alerta proativas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeActiveMetricRuleList

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

Product

String

Sim

ecs

A abreviação do serviço em nuvem compatível com regras de alerta proativas.

Para mais informações sobre como obter o nome de um serviço em nuvem, consulte DescribeProductsOfActiveMetricRule.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
CodeString200

O código de status HTTP.

Nota O código de status 200 indica que a solicitação foi bem-sucedida.
MessageStringThe Request is not authorization.

A mensagem de erro.

RequestIdStringF82E6667-7811-4BA0-842F-5B2DC42BBAAD

O ID da solicitação.

SuccessBooleantrue

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

  • true
  • false
DatapointsArray of Alarm

Os detalhes das regras de alerta.

Alarm
SilenceTimeString86400

O período de silêncio durante o qual novos alertas não são enviados, mesmo que as condições de acionamento sejam atendidas.

Unidade: segundos.

MetricNameStringcpu_total

O nome da métrica.

EvaluationCountString3

O número consecutivo de vezes em que o valor da métrica atende à condição de acionamento antes do disparo do alerta.

WebhookStringhttps://www.aliyun.com

A URL de callback.

StateStringEnable

Indica se a regra de alerta está ativada.

ContactGroupsStringECS_Group

O grupo de contatos de alerta.

NamespaceStringacs_ecs_dashboard

O namespace do serviço em nuvem.

RuleNameStringSystemDefault_acs_rds_dashboard_CpuUsage

O nome da regra de alerta.

RuleIdStringa151cd6023eacee2f0978e03863cc1697c89508****

O ID da regra de alerta.

PeriodString60

O período de agregação dos dados de monitoramento.

Unidade: segundos.

ComparisonOperatorString>

O operador de comparação usado na regra de alerta. Valores válidos:

  • >
  • <
  • >=
  • <=
  • =
  • =
EndTimeString24

O fim do período de vigência da regra de alerta.

Unidade: horas. Por exemplo, o valor 23 indica 23:59:59.

StartTimeString00

O início do período de vigência da regra de alerta.

Unidade: horas. Por exemplo, o valor 00 indica 00:00:00.

ThresholdString90

O limiar de alerta.

StatisticsStringAverage

O método estatístico.

EnableStringtrue

Indica se a regra de alerta está ativada. Valores válidos:

  • true: A regra de alerta está ativada.
  • false: A regra de alerta está desativada.
AlertListArray of Alert

Os detalhes das regras de alerta. O resultado possui a mesma estrutura retornada pela operação DescribeMetricRuleList.

Alert
SilenceTimeString86400

O período de silêncio durante o qual novos alertas não são enviados, mesmo que as condições de acionamento sejam atendidas.

Unidade: segundos.

MetricNameStringcpu_total

O nome da métrica.

WebhookStringhttp://www.aliyun.com

A URL de callback.

ContactGroupsStringECS_Group

O grupo de contatos de alerta.

NamespaceStringacs_ecs_dashboard

O namespace do serviço em nuvem.

EffectiveIntervalString00:00-23:59

O período de vigência da regra de alerta.

NoEffectiveIntervalString00:00-06:00

O período de inatividade da regra de alerta.

MailSubjectStringECS_Bucket

O assunto do e-mail de notificação de alerta.

RuleNameStringmyAlert

O nome da regra de alerta.

RuleIdStringruleIdxxxx

O ID da regra de alerta.

PeriodString60

O período de agregação dos dados de monitoramento.

Unidade: segundos.

AlertStateStringOK

O status da regra de alerta. Valores válidos:

  • OK: A regra de alerta não possui alertas ativos.
  • ALARM: A regra de alerta possui alertas ativos.
  • INSUFFICIENT_DATA: Não há dados disponíveis.
DimensionsString""

Os dados de monitoramento do recurso especificado.

EnableStateBooleantrue

Indica se a regra de alerta está ativada. Valores válidos:

  • true: A regra de alerta está ativada.
  • false: A regra de alerta está desativada.
ResourcesString[{"resource":"_ALL"}]

Os recursos associados à regra de alerta.

EscalationsObject

As condições para acionar diferentes níveis de alertas.

InfoObject

As condições para acionar alertas de nível Info.

ComparisonOperatorStringGreaterThanThreshold

O operador de comparação usado para comparar o valor da métrica com o limiar para alertas de nível Info. Valores válidos:

  • GreaterThanOrEqualToThreshold: maior ou igual ao limiar
  • GreaterThanThreshold: maior que o limiar
  • LessThanOrEqualToThreshold: menor ou igual ao limiar
  • LessThanThreshold: menor que o limiar
  • NotEqualToThreshold: diferente do limiar
  • GreaterThanYesterday: maior que o valor da métrica no mesmo horário ontem
  • LessThanYesterday: menor que o valor da métrica no mesmo horário ontem
  • GreaterThanLastWeek: maior que o valor da métrica no mesmo horário na semana passada
  • LessThanLastWeek: menor que o valor da métrica no mesmo horário na semana passada
  • GreaterThanLastPeriod: maior que o valor da métrica no último ciclo de monitoramento
  • LessThanLastPeriod: menor que o valor da métrica no último ciclo de monitoramento
TimesString3

O número consecutivo de vezes em que o valor da métrica excede o limiar para alertas de nível Info antes do disparo do alerta.

ThresholdString95

O limiar para alertas de nível Info.

StatisticsStringAverage

Os métodos estatísticos para alertas de nível Info.

WarnObject

A condição para acionar alertas de nível Warn.

ComparisonOperatorStringGreaterThanThreshold

O operador de comparação usado para comparar o valor da métrica com o limiar para alertas de nível Critical. Valores válidos:

  • GreaterThanOrEqualToThreshold: maior ou igual ao limiar
  • GreaterThanThreshold: maior que o limiar
  • LessThanOrEqualToThreshold: menor ou igual ao limiar
  • LessThanThreshold: menor que o limiar
  • NotEqualToThreshold: diferente do limiar
  • GreaterThanYesterday: maior que o valor da métrica no mesmo horário ontem
  • LessThanYesterday: menor que o valor da métrica no mesmo horário ontem
  • GreaterThanLastWeek: maior que o valor da métrica no mesmo horário na semana passada
  • LessThanLastWeek: menor que o valor da métrica no mesmo horário na semana passada
  • GreaterThanLastPeriod: maior que o valor da métrica no último ciclo de monitoramento
  • LessThanLastPeriod: menor que o valor da métrica no último ciclo de monitoramento
TimesString3

O número consecutivo de vezes em que o valor da métrica excede o limiar para alertas de nível Warn antes do disparo do alerta.

ThresholdString80

O limiar para alertas de nível Warn.

StatisticsStringAverage

Os métodos estatísticos para alertas de nível Warn.

CriticalObject

As condições para acionar alertas de nível Critical.

ComparisonOperatorStringGreaterThanThreshold

O operador de comparação usado para comparar o valor da métrica com o limiar para alertas de nível Critical. Valores válidos:

  • GreaterThanOrEqualToThreshold: maior ou igual ao limiar
  • GreaterThanThreshold: maior que o limiar
  • LessThanOrEqualToThreshold: menor ou igual ao limiar
  • LessThanThreshold: menor que o limiar
  • NotEqualToThreshold: diferente do limiar
  • GreaterThanYesterday: maior que o valor da métrica no mesmo horário ontem
  • LessThanYesterday: menor que o valor da métrica no mesmo horário ontem
  • GreaterThanLastWeek: maior que o valor da métrica no mesmo horário na semana passada
  • LessThanLastWeek: menor que o valor da métrica no mesmo horário na semana passada
  • GreaterThanLastPeriod: maior que o valor da métrica no último ciclo de monitoramento
  • LessThanLastPeriod: menor que o valor da métrica no último ciclo de monitoramento
TimesString3

O número consecutivo de vezes em que o valor da métrica excede o limiar para alertas de nível Critical antes do disparo do alerta.

ThresholdString99

O limiar para alertas de nível Critical.

StatisticsStringAverage

Os métodos estatísticos para alertas de nível Critical.

Exemplos

Solicitações de exemplo

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

Respostas de sucesso de exemplo

Formato XML

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

<DescribeActiveMetricRuleListResponse>
        <AlertList>
            <Alert>
                <SilenceTime>86400</SilenceTime>
                <ContactGroups>ECS_Group</ContactGroups>
                <NoEffectiveInterval></NoEffectiveInterval>
                <MailSubject>${serviceType}-${metricName}-${levelDescription}</MailSubject>
                <RuleId>SystemDefault_acs_rds_dashboard_IOPSUsage</RuleId>
                <Period>300</Period>
                <Dimensions></Dimensions>
                <EffectiveInterval></EffectiveInterval>
                <Namespace>acs_rds_dashboard</Namespace>
                <AlertState>INSUFFICIENT_DATA</AlertState>
                <MetricName>IOPSUsage</MetricName>
                <EnableState>true</EnableState>
                <Escalations>
                    <Critical />
                    <Info>
                        <ComparisonOperator>GreaterThanThreshold</ComparisonOperator>
                        <Times>5</Times>
                        <Statistics>Average</Statistics>
                        <Threshold>80</Threshold>
                    </Info>
                    <Warn />
                </Escalations>
                <Webhook></Webhook>
                <Resources>[{\"resource\":\"_ALL\"}]</Resources>
                <RuleName>SystemDefault_acs_rds_dashboard_IOPSUsage</RuleName>
            </Alert>
            <Alert>
                <SilenceTime>86400</SilenceTime>
                <ContactGroups>ECS_Group</ContactGroups>
                <NoEffectiveInterval></NoEffectiveInterval>
                <MailSubject>${serviceType}-${metricName}-${levelDescription}</MailSubject>
                <RuleId>SystemDefault_acs_rds_dashboard_CpuUsage</RuleId>
                <Period>300</Period>
                <Dimensions></Dimensions>
                <EffectiveInterval></EffectiveInterval>
                <Namespace>acs_rds_dashboard</Namespace>
                <AlertState>INSUFFICIENT_DATA</AlertState>
                <MetricName>CpuUsage</MetricName>
                <EnableState>true</EnableState>
                <Escalations>
                    <Critical />
                    <Info>
                        <ComparisonOperator>GreaterThanThreshold</ComparisonOperator>
                        <Times>5</Times>
                        <Statistics>Average</Statistics>
                        <Threshold>80</Threshold>
                    </Info>
                    <Warn />
                </Escalations>
                <Webhook></Webhook>
                <Resources>[{\"resource\":\"_ALL\"}]</Resources>
                <RuleName>SystemDefault_acs_rds_dashboard_CpuUsage</RuleName>
            </Alert>
        </AlertList>
        <Datapoints>
            <Alarm>
                <SilenceTime>86400</SilenceTime>
                <ContactGroups>[\"Alice\"]</ContactGroups>
                <ComparisonOperator>GreaterThanThreshold</ComparisonOperator>
                <EndTime></EndTime>
                <RuleId>SystemDefault_acs_rds_dashboard_IOPSUsage</RuleId>
                <StartTime></StartTime>
                <Period>300</Period>
                <EvaluationCount>5</EvaluationCount>
                <Statistics>Average</Statistics>
                <Namespace>acs_rds_dashboard</Namespace>
                <MetricName>IOPSUsage</MetricName>
                <State>INSUFFICIENT_DATA</State>
                <Enable>true</Enable>
                <Webhook></Webhook>
                <RuleName>SystemDefault_acs_rds_dashboard_IOPSUsage</RuleName>
                <Threshold>80</Threshold>
            </Alarm>
            <Alarm>
                <SilenceTime>86400</SilenceTime>
                <ContactGroups>[\"Jim\"]</ContactGroups>
                <ComparisonOperator>GreaterThanThreshold</ComparisonOperator>
                <EndTime></EndTime>
                <RuleId>SystemDefault_acs_rds_dashboard_CpuUsage</RuleId>
                <StartTime></StartTime>
                <Period>300</Period>
                <EvaluationCount>5</EvaluationCount>
                <Statistics>Average</Statistics>
                <Namespace>acs_rds_dashboard</Namespace>
                <MetricName>CpuUsage</MetricName>
                <State>INSUFFICIENT_DATA</State>
                <Enable>true</Enable>
                <Webhook></Webhook>
                <RuleName>SystemDefault_acs_rds_dashboard_CpuUsage</RuleName>
                <Threshold>80</Threshold>
            </Alarm>
        </Datapoints>
        <Code>200</Code>
        <Success>true</Success>
</DescribeActiveMetricRuleListResponse>

Formato JSON

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

{
  "AlertList" : {
    "Alert" : [ {
      "SilenceTime" : 86400,
      "ContactGroups" : "ECS_Group",
      "NoEffectiveInterval" : "",
      "MailSubject" : "${serviceType}-${metricName}-${levelDescription}",
      "RuleId" : "SystemDefault_acs_rds_dashboard_IOPSUsage",
      "Period" : 300,
      "Dimensions" : "",
      "EffectiveInterval" : "",
      "Namespace" : "acs_rds_dashboard",
      "AlertState" : "INSUFFICIENT_DATA",
      "MetricName" : "IOPSUsage",
      "EnableState" : true,
      "Escalations" : {
        "Critical" : { },
        "Info" : {
          "ComparisonOperator" : "GreaterThanThreshold",
          "Times" : 5,
          "Statistics" : "Average",
          "Threshold" : "80"
        },
        "Warn" : { }
      },
      "Webhook" : "",
      "Resources" : "[{\"resource\":\"_ALL\"}]",
      "RuleName" : "SystemDefault_acs_rds_dashboard_IOPSUsage"
    }, {
      "SilenceTime" : 86400,
      "ContactGroups" : "ECS_Group",
      "NoEffectiveInterval" : "",
      "MailSubject" : "${serviceType}-${metricName}-${levelDescription}",
      "RuleId" : "SystemDefault_acs_rds_dashboard_CpuUsage",
      "Period" : 300,
      "Dimensions" : "",
      "EffectiveInterval" : "",
      "Namespace" : "acs_rds_dashboard",
      "AlertState" : "INSUFFICIENT_DATA",
      "MetricName" : "CpuUsage",
      "EnableState" : true,
      "Escalations" : {
        "Critical" : { },
        "Info" : {
          "ComparisonOperator" : "GreaterThanThreshold",
          "Times" : 5,
          "Statistics" : "Average",
          "Threshold" : "80"
        },
        "Warn" : { }
      },
      "Webhook" : "",
      "Resources" : "[{\"resource\":\"_ALL\"}]",
      "RuleName" : "SystemDefault_acs_rds_dashboard_CpuUsage"
    } ]
  },
  "Datapoints" : {
    "Alarm" : [ {
      "SilenceTime" : 86400,
      "ContactGroups" : "[\"Alice\"]",
      "ComparisonOperator" : "GreaterThanThreshold",
      "EndTime" : "",
      "RuleId" : "SystemDefault_acs_rds_dashboard_IOPSUsage",
      "StartTime" : "",
      "Period" : 300,
      "EvaluationCount" : 5,
      "Statistics" : "Average",
      "Namespace" : "acs_rds_dashboard",
      "MetricName" : "IOPSUsage",
      "State" : "INSUFFICIENT_DATA",
      "Enable" : true,
      "Webhook" : "",
      "RuleName" : "SystemDefault_acs_rds_dashboard_IOPSUsage",
      "Threshold" : "80"
    }, {
      "SilenceTime" : 86400,
      "ContactGroups" : "[\"Jim\"]",
      "ComparisonOperator" : "GreaterThanThreshold",
      "EndTime" : "",
      "RuleId" : "SystemDefault_acs_rds_dashboard_CpuUsage",
      "StartTime" : "",
      "Period" : 300,
      "EvaluationCount" : 5,
      "Statistics" : "Average",
      "Namespace" : "acs_rds_dashboard",
      "MetricName" : "CpuUsage",
      "State" : "INSUFFICIENT_DATA",
      "Enable" : true,
      "Webhook" : "",
      "RuleName" : "SystemDefault_acs_rds_dashboard_CpuUsage",
      "Threshold" : "80"
    } ]
  },
  "Code" : "200",
  "Success" : true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

404

ResourceNotFound

The specified resource is not found.

O recurso especificado não foi encontrado.

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