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

Este tópico apresenta um exemplo de criação de regra de alerta acionada por limiar para a métrica cpu_total de uma instância do Elastic Compute Service (ECS) com ID i-uf6j91r34rnwawoo****. O namespace do ECS é acs_ecs_dashboard, e o grupo de contatos de alerta da regra é ECS_Group. A regra de alerta recebe o nome test123 e o ID a151cd6023eacee2f0978e03863cc1697c89508****. Para alertas de nível Critical, o método estatístico é Average, o operador de comparação é GreaterThanOrEqualToThreshold e o limiar é 90. O alerta de nível Critical é acionado quando o valor da métrica atende à condição de acionamento por 3 vezes consecutivas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	PutResourceMetricRules	Operação a ser executada. Defina o valor como PutResourceMetricRules.
Rules.N.Escalations.Info.Threshold	String	Não	90	Limiar para alertas de nível Info. 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.
Rules.N.MetricName	String	Não	cpu_total	Nome da métrica. Valores válidos de N: 1 a 500. Para consultar o nome de uma métrica, consulte Apêndice 1: Métricas.
Rules.N.Escalations.Warn.Threshold	String	Não	90	Limiar para alertas de nível Warn. Valores válidos de N: 1 a 500. 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.
Rules.N.EffectiveInterval	String	Não	00:00-23:59	Período de vigência da regra de alerta. Valores válidos de N: 1 a 500.
Rules.N.NoEffectiveInterval	String	Não	00:00-06:00	Período de inatividade da regra de alerta. Valores válidos de N: 1 a 500.
Rules.N.RuleId	String	Sim	a151cd6023eacee2f0978e03863cc1697c89508****	ID da regra de alerta. Valores válidos de N: 1 a 500. Especifique um novo ID ou o ID de uma regra existente. Para consultar o ID de uma regra de alerta, consulte DescribeMetricRuleList. Nota Ao especificar um novo ID, o sistema cria uma regra de alerta acionada por limiar.
Rules.N.Escalations.Critical.Times	Integer	Não	3	Número consecutivo de vezes em que o valor da métrica deve atender à condição de alerta antes de acionar um alerta de nível Critical. Valores válidos de N: 1 a 500. 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.
Rules.N.Escalations.Critical.Threshold	String	Não	90	Limiar para alertas de nível Critical. Valores válidos de N: 1 a 500. 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.
Rules.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 500. O valor deste parâmetro depende da coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. Os valores aceitos são Maximum, Minimum ou Average. Para obter esse valor, 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.
Rules.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 500. 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.
Rules.N.Escalations.Info.Times	Integer	Não	3	Número consecutivo de vezes em que o valor da métrica deve atender à condição de alerta antes de acionar um alerta de nível Info. Valores válidos de N: 1 a 500. 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.
Rules.N.Resources	String	Sim	[{"instanceId":"i-uf6j91r34rnwawoo****"}]	Informações sobre o recurso. Exemplos: `[{"instanceId":"i-uf6j91r34rnwawoo"}]` e `[{"userId":"100931896542"}]`. Valores válidos de N: 1 a 500. Para mais informações sobre as dimensões compatíveis com a consulta de recursos, consulte Apêndice 1: Métricas.
Rules.N.SilenceTime	Integer	Não	86400	Período de silêncio durante o qual novas notificações de alerta não são enviadas, mesmo se as condições de acionamento forem atendidas. Unidade: segundos. Valor padrão: 86400. Valores válidos de N: 1 a 500. Nota Se o alerta não for resolvido após o fim do período de silêncio, o CloudMonitor reenvia uma notificação.
Rules.N.Webhook	String	Não	https://alert.aliyun.com.com:8080/callback	URL de callback para envio de solicitação POST quando um alerta baseado nesta regra é acionado. Valores válidos de N: 1 a 500.
Rules.N.ContactGroups	String	Sim	ECS_Group	Grupos de contatos de alerta. As notificações são enviadas aos contatos pertencentes a esses grupos. Valores válidos de N: 1 a 500. Nota Um grupo de contatos de alerta pode conter um ou mais contatos. Para criar contatos e grupos de contatos de alerta, consulte PutContact e PutContactGroup.
Rules.N.Namespace	String	Sim	acs_ecs_dashboard	Namespace do serviço de nuvem. Valores válidos de N: 1 a 500. Para consultar o namespace de um serviço de nuvem, consulte Apêndice 1: Métricas.
Rules.N.EmailSubject	String	Não	Alert for an ECS instance	Assunto do e-mail de notificação de alerta. Valores válidos de N: 1 a 500.
Rules.N.Period	String	Não	60	Período estatístico da métrica. Unidade: segundos. O valor padrão corresponde ao intervalo de coleta dos dados de monitoramento da métrica. Valores válidos de N: 1 a 500. Nota Para consultar o período estatístico de uma métrica, consulte Apêndice 1: Métricas.
Rules.N.RuleName	String	Sim	test123	Nome da regra de alerta. Valores válidos de N: 1 a 500. Especifique um novo nome ou o nome de uma regra existente. Para consultar o nome de uma regra de alerta, consulte DescribeMetricRuleList. Nota Ao especificar um novo nome, o sistema cria uma regra de alerta acionada por limiar.
Rules.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 500. O valor deste parâmetro depende da coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. Os valores aceitos são Maximum, Minimum ou Average. Para obter esse valor, 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.
Rules.N.Escalations.Warn.Times	Integer	Não	3	Número consecutivo de vezes em que o valor da métrica deve atender à condição de alerta antes de acionar um alerta de nível Warn. Valores válidos de N: 1 a 500. 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.
Rules.N.Escalations.Info.ComparisonOperator	String	Não	GreaterThanOrEqualToThreshold	Operador de comparação do 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 Valores válidos de N: 1 a 500. 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.
Rules.N.Interval	String	Não	60	Intervalo de acionamento dos alertas com base na regra. Unidade: segundos. Valores válidos de N: 1 a 500. Nota Para consultar o período estatístico de uma métrica, consulte Apêndice 1: Métricas.
Rules.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 500. 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.
Rules.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 500. O valor deste parâmetro depende da coluna `Statistics` correspondente ao parâmetro `MetricName` do serviço de nuvem especificado. Os valores aceitos são Maximum, Minimum ou Average. Para obter esse valor, 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.
Rules.N.NoDataPolicy	String	Não	KEEP_LAST_STATE	Ação executada quando não há dados de monitoramento. Valores válidos: KEEP_LAST_STATE (valor padrão): Nenhuma ação é executada. INSUFFICIENT_DATA: Aciona um alerta com o conteúdo "Insufficient data". OK: Considera o status normal. Valores válidos de N: 1 a 500.
Rules.N.Labels.N.Key	String	Não	tagKey1	Chave da tag.
Rules.N.Labels.N.Value	String	Não	ECS	Valor da tag. Nota Use um parâmetro de modelo para definir um valor de tag. O CloudMonitor substitui o valor do parâmetro de modelo pelo valor real da tag.

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

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	Código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Message	String	The request processing has failed due to some unknown error.	Mensagem de erro.
RequestId	String	15D1440E-BF24-5A41-93E4-36864635179E	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.
FailedListResult	Array of Target		Regras de alerta cuja criação falhou para o recurso.
Target
RuleId	String	a151cd6023eacee2f0978e03863cc1697c89508****	ID da regra de alerta.
Result	Object		Regra de alerta cuja criação falhou.
Code	String	404	Código de status.
Message	String	The request processing has failed due to some unknown error.	Mensagem de erro.
Success	Boolean	false	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=PutResourceMetricRules
&Rules.1.ContactGroups=ECS_Group
&Rules.1.MetricName=cpu_total
&Rules.1.Namespace=acs_ecs_dashboard
&Rules.1.Resources=[{"instanceId":"i-uf6j91r34rnwawoo****"}]
&Rules.1.RuleId=a151cd6023eacee2f0978e03863cc1697c89508****
&Rules.1.RuleName=test123
&Rules.1.Escalations.Critical.Statistics=Average
&Rules.1.Escalations.Critical.ComparisonOperator=GreaterThanOrEqualToThreshold
&Rules.1.Escalations.Critical.Threshold=90
&Rules.1.Escalations.Critical.Times=3
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<PutResourceMetricRulesResponse>
	<Message></Message>
	<RequestId>15D1440E-BF24-5A41-93E4-36864635179E</RequestId>
	<FailedListResult></FailedListResult>
	<Code>200</Code>
	<Success>true</Success>
</PutResourceMetricRulesResponse>

Formato JSON

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

{
  "Message" : "",
  "RequestId" : "15D1440E-BF24-5A41-93E4-36864635179E",
  "FailedListResult" : {
    "Target" : [ ]
  },
  "Code" : "200",
  "Success" : true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.