ModifyMetricRuleTemplate - : Central de Documentação do Alibaba Cloud

Este tópico fornece um exemplo de como modificar um modelo de alerta cuja versão é 1 e cujo ID é 123456. O nível de alerta é alterado para Critical. O método estatístico é alterado para Average. O operador de comparação do limiar de alerta é alterado para GreaterThanOrEqualToThreshold. O limiar de alerta é alterado para 90. O número de tentativas de alerta é alterado para 3. O resultado retornado indica que o modelo de alerta foi modificado.

Debugging

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior praticidade, 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 de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyMetricRuleTemplate	A operação a ser executada. Defina o valor como ModifyMetricRuleTemplate.
TemplateId	Long	Yes	123456	O ID do modelo de alerta. Para saber como obter o ID de um modelo de alerta, consulte DescribeMetricRuleTemplateList.
Name	String	No	Template_123	O nome do modelo de alerta. Para saber como obter o nome de um modelo de alerta, consulte DescribeMetricRuleTemplateList.
Description	String	No	ECS_template1	A descrição do modelo de alerta.
RestVersion	Long	Yes	1	A versão do modelo de alerta. A versão muda conforme o número de modificações aplicadas ao modelo. Para saber como obter a versão de um modelo de alerta, consulte DescribeMetricRuleTemplateList.
AlertTemplates.N.Escalations.Info.Threshold	String	No	20	O 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.MetricName	String	No	cpu_total	O nome da métrica. Valores válidos de N: 1 a 200. Para saber como obter uma métrica, consulte DescribeMetricMetaList ou Appendix 1: Metrics.
AlertTemplates.N.Webhook	String	No	http://www.aliyun.com	A 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 notificação de alerta para a URL de callback especificada por meio de uma requisição HTTP POST. Somente o protocolo HTTP é compatível.
AlertTemplates.N.Escalations.Warn.Threshold	String	No	30	O 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Namespace	String	No	acs_ecs_dashboard	O namespace do serviço de nuvem. Valores válidos de N: 1 a 200. Para saber como obter o namespace de um serviço de nuvem, consulte DescribeMetricMetaList ou Appendix 1: Metrics.
AlertTemplates.N.Period	Integer	No	60	O período estatístico dos dados de monitoramento. Valores válidos de N: 1 a 200. Nota Com o valor definido como 300 segundos, os dados de monitoramento são coletados a cada 300 segundos. Se os dados forem reportados a cada 1 minuto, o sistema de alertas calculará os valores médio, máximo e mínimo dos dados de monitoramento dos últimos 5 minutos e verificará se os valores agregados excedem o limiar. Para evitar alertas inesperados, recomendamos definir este parâmetro em conjunto com outros parâmetros.
AlertTemplates.N.RuleName	String	No	Rule_123	O nome da regra de alerta. Valores válidos de N: 1 a 200.
AlertTemplates.N.Escalations.Critical.Times	Integer	No	2	O número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes que um alerta de nível Critical seja disparado. Valores válidos de N: 1 a 200. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Selector	String	No	{"disk":"/"}	A dimensão do alerta. Trata-se de um campo estendido. Valores válidos de N: 1 a 200. Por exemplo, quando um modelo de alerta é aplicado a um grupo de aplicações com este parâmetro definido como `{"disk":"/"}` e o parâmetro MetricName definido como `DiskUtilization`, a regra de alerta gerada é aplicada à partição de disco raiz (`"/"`) de todas as instâncias do grupo de aplicações ao qual o modelo está aplicado. Nota Para mais informações sobre os valores dos campos estendidos, consulte DescribeMetricRuleTemplateAttribute.
AlertTemplates.N.Escalations.Info.Statistics	String	No	Average	O método estatístico para alertas de nível Info. Valores válidos de N: 1 a 200. O valor deste parâmetro é determinado pela coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. O valor pode ser Maximum, Minimum ou Average. Para mais informações sobre como obter o valor deste parâmetro, consulte Appendix 1: Metrics. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Warn.Times	Integer	No	1	O número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes que um alerta de nível Warn seja disparado. Valores válidos de N: 1 a 200. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Info.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	O operador 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 de ontem LessThanYesterday: menor que o valor da métrica no mesmo horário de ontem GreaterThanLastWeek: maior que o valor da métrica no mesmo horário da semana passada LessThanLastWeek: menor que o valor da métrica no mesmo horário da 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Category	String	No	ecs	A abreviação do nome do serviço de nuvem. Valores válidos de N: 1 a 200. Para saber como 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	No	30	O 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Critical.Statistics	String	No	Average	O método estatístico para alertas de nível Critical. Valores válidos de N: 1 a 200. O valor deste parâmetro é determinado pela coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. O valor pode ser Maximum, Minimum ou Average. Para mais informações sobre como obter o valor deste parâmetro, consulte Appendix 1: Metrics. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Critical.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	O operador 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 de ontem LessThanYesterday: menor que o valor da métrica no mesmo horário de ontem GreaterThanLastWeek: maior que o valor da métrica no mesmo horário da semana passada LessThanLastWeek: menor que o valor da métrica no mesmo horário da 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Warn.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	O operador usado para comparar o valor da métrica com o limiar para 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 de ontem LessThanYesterday: menor que o valor da métrica no mesmo horário de ontem GreaterThanLastWeek: maior que o valor da métrica no mesmo horário da semana passada LessThanLastWeek: menor que o valor da métrica no mesmo horário da 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 e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Info.Times	Integer	No	1	O número consecutivo de vezes em que o valor da métrica atende à condição de alerta antes que um alerta de nível Info seja disparado. Valores válidos de N: 1 a 200. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.
AlertTemplates.N.Escalations.Warn.Statistics	String	No	Average	O método estatístico para alertas de nível Warn. Valores válidos de N: 1 a 200. O valor deste parâmetro é determinado pela coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. O valor pode ser Maximum, Minimum ou Average. Para mais informações sobre como obter o valor deste parâmetro, consulte Appendix 1: Metrics. Nota Selecione pelo menos um dos níveis de alerta Critical, Warn e Info e especifique os parâmetros Statistics, ComparisonOperator, Threshold e Times para o nível selecionado.

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

Parâmetros de resposta

Parameter	Type	Example	Description
Code	Integer	200	O 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.	A mensagem retornada.
RequestId	String	9E07117F-F6AE-4F1C-81E8-36FBB4892235	O 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.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ModifyMetricRuleTemplate
&TemplateId=123456
&RestVersion=0
&<Common request parameters>

Exemplos de respostas bem-sucedidas

Formato XML

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

<ModifyMetricRuleTemplateResponse>
		<RequestId>97EAC0E2-CD54-4183-95AC-F0C113024E18</RequestId>
		<Code>200</Code>
		<Success>true</Success>
</ModifyMetricRuleTemplateResponse>

Formato JSON

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

{
  "RequestId" : "5F78F035-3369-4360-810E-D5CC5E774336",
  "Code" : 200,
  "Success" : true
}

Códigos de erro

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