Todos os produtos
Search
Central de documentação

:CreateMetricRuleTemplate

Última atualização: Jun 26, 2026

Cria um modelo de alerta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateMetricRuleTemplate

Operação a ser executada. Defina o valor como CreateMetricRuleTemplate.

Name String Sim Template1

Nome do modelo de alerta.

Description String Não ECS_Template1

Descrição do modelo de alerta.

AlertTemplates.N.Escalations.Info.Threshold String Não 20

Limiar para alertas de nível Info.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.MetricName String Sim cpu_total

Nome da métrica.

Valores válidos de N: 1 a 200.

Para obter informações sobre as métricas, consulte DescribeMetricMetaList ou Apêndice 1: Métricas.

AlertTemplates.N.Webhook String Não http://ww.aliyun.com

URL de callback.

Valores válidos de N: 1 a 200.

A URL de callback deve ser acessível pela Internet. O CloudMonitor envia uma solicitação POST para encaminhar a notificação de alerta ao endereço especificado. Somente solicitações HTTP são suportadas.

AlertTemplates.N.Escalations.Warn.Threshold String Não 30

Limiar para alertas de nível Warn.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Namespace String Sim acs_ecs_dashboard

Namespace do serviço de nuvem.

Valores válidos de N: 1 a 200.

Para obter o namespace de um serviço de nuvem, consulte DescribeMetricMetaList ou Apêndice 1: Métricas.

AlertTemplates.N.Period Integer Não 60

Período de agregação dos dados de monitoramento. Unidade: segundos.

O valor padrão corresponde ao período mínimo de agregação. Geralmente, não é necessário especificar esse valor.

Valores válidos de N: 1 a 200.

AlertTemplates.N.RuleName String Sim ECS_Rule1

Nome da regra de alerta.

Valores válidos de N: 1 a 200.

AlertTemplates.N.Escalations.Critical.Times Integer Não 3

Número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes da ativação de um alerta de nível Critical.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Selector String Não {"disk":"/"}

Dimensão do alerta. Este é um campo estendido.

Valores válidos de N: 1 a 200.

Por exemplo, se você aplicar um modelo de alerta a um grupo de aplicativos, definir este parâmetro como {"disk":"/"} e configurar MetricName como DiskUtilization, a regra gerada incidirá sobre a partição de disco raiz ("/") de todas as instâncias desse grupo.

Nota Para mais informações sobre valores de campos estendidos, consulte DescribeMetricRuleTemplateAttribute.
AlertTemplates.N.Escalations.Info.Statistics String Não Average

Método estatístico para alertas de nível Info.

Valores válidos de N: 1 a 200.

Este valor depende da coluna Statistics correspondente ao parâmetro MetricName do serviço de nuvem especificado. Os valores possíveis são Maximum, Minimum ou Average. Para saber como obter essa informação, consulte Apêndice 1: Métricas.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Warn.Times Integer Não 1

Número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes da ativação de um alerta de nível Warn.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Info.ComparisonOperator String Não GreaterThanOrEqualToThreshold

Operador usado para comparar o valor da métrica com o limiar em 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

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Category String Sim ecs

Abreviação do nome do serviço de nuvem.

Valores válidos de N: 1 a 200.

Para obter a abreviação do nome de um serviço de nuvem, consulte metricCategory no parâmetro de resposta Labels da operação DescribeProjectMeta.

AlertTemplates.N.Escalations.Critical.Threshold String Não 30

Limiar para alertas de nível Critical.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Critical.Statistics String Não Average

Método estatístico para alertas de nível Critical.

Valores válidos de N: 1 a 200.

Este valor depende da coluna Statistics correspondente ao parâmetro MetricName do serviço de nuvem especificado. Os valores possíveis são Maximum, Minimum ou Average. Para saber como obter essa informação, consulte Apêndice 1: Métricas.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Critical.ComparisonOperator String Não GreaterThanOrEqualToThreshold

Operador usado para comparar o valor da métrica com o limiar em 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

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Warn.ComparisonOperator String Não GreaterThanOrEqualToThreshold

Operador usado para comparar o valor da métrica com o limiar em alertas de nível Warn. 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

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Info.Times Integer Não 1

Número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes da ativação de um alerta de nível Info.

Valores válidos de N: 1 a 200.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.
AlertTemplates.N.Escalations.Warn.Statistics String Não Average

Método estatístico para alertas de nível Warn.

Valores válidos de N: 1 a 200.

Este valor depende da coluna Statistics correspondente ao parâmetro MetricName do serviço de nuvem especificado. Os valores possíveis são Maximum, Minimum ou Average. Para saber como obter essa informação, consulte Apêndice 1: Métricas.

Nota Selecione pelo menos um dos níveis de alerta Critical, Warn ou Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível escolhido.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
Code Integer 200

Código de status HTTP.

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

Mensagem retornada.

RequestId String 9763ED1A-4D09-41BF-851E-310421750204

ID da solicitação.

Success Boolean true

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: A chamada foi bem-sucedida.
  • false: A chamada falhou.
Id Long 12345

ID do modelo de alerta.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateMetricRuleTemplate
&Name=Template1
&AlertTemplates.1.MetricName=cpu_total
&AlertTemplates.1.RuleName=My CPU monitoring
&AlertTemplates.1.Category=ecs
&AlertTemplates.1.1amespace=acs_ecs_dashboard
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateMetricRuleTemplateResponse>
		<RequestId>9763ED1A-4D09-41BF-851E-310421750204</RequestId>
		<Id>12345</Id>
		<Success>true</Success>
		<Code>200</Code>
</CreateMetricRuleTemplateResponse>

Formato JSON

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

{
  "RequestId" : "9763ED1A-4D09-41BF-851E-310421750204",
  "Id" : 12345,
  "Success" : true,
  "Code" : 200
}

Códigos de erro

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