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

Antes de chamar esta operação, chame a operação PutCustomMetric para reportar dados de monitoramento personalizados. Para mais informações, consulte PutCustomMetric.

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	PutCustomMetricRule	A operação que você deseja executar. Defina o valor como PutCustomMetricRule.
ComparisonOperator	String	Yes	>=	O operador de comparação aplicado antes do limiar. Valores válidos: `>=` `=` `<=` `>` `<` `!=`
ContactGroups	String	Yes	ECS_Group	O grupo de alertas que recebe as notificações de alerta. Separe múltiplos grupos de alertas com vírgulas (,).
EvaluationCount	Integer	Yes	3	O número consecutivo de vezes em que o valor da métrica é medido antes de um alerta ser acionado.
Level	String	Yes	CRITICAL	O nível do alerta. Valores válidos: CRITICAL WARN INFO
MetricName	String	Yes	cpu_total	O nome da métrica. Nota Para mais informações sobre como obter o nome da métrica, consulte DescribeCustomMetricList.
Resources	String	Yes	[{"groupId":7378**,"dimension":"instanceId=i-hp3543t5e4sudb3s**"}]	Os dados de monitoramento personalizados aos quais a regra de alerta se aplica. O valor inclui o ID do grupo de aplicação ao qual os dados de monitoramento personalizados pertencem e a dimensão à qual a métrica pertence.
RuleId	String	Yes	MyRuleId1	O ID da regra de alerta. Nota Especifique um ID existente para modifique a regra de alerta correspondente ou especifique um novo ID para crie uma regra de alerta.
Statistics	String	Yes	Average	O método utilizado para calcular os valores da métrica que acionam alertas.
Threshold	String	Yes	90	O limiar do valor da métrica.
GroupId	String	No	7378****	O ID do grupo de aplicação ao qual os dados de monitoramento personalizados pertencem. Nota O valor 0 indica que os dados de monitoramento personalizados reportados não pertencem a nenhum grupo de aplicação.
RuleName	String	No	CpuUsage	O nome da regra de alerta.
Webhook	String	No	https://www.aliyun.com	A URL de callback para a qual uma requisição POST é enviada quando um alerta é acionado com base na regra de alerta.
EffectiveInterval	String	No	00:00-23:59	O período durante o qual a regra de alerta está ativa. Valores válidos: 00:00 a 23:59.
SilenceTime	Integer	No	86400	O período de silêncio durante o qual as notificações não são reenviadas para um alerta. Unidade: segundos. Valor padrão: 86400. O valor padrão equivale a um dia. Nota Apenas uma notificação de alerta é enviada durante cada período de silêncio, mesmo que o valor da métrica exceda consecutivamente o limiar do alerta várias vezes.
Period	String	No	300	O ciclo utilizado para agregar dados de monitoramento personalizados. Unidade: segundos. Defina o valor como um múltiplo inteiro de 60. Por padrão, é utilizado o ciclo de reporte original dos dados de monitoramento personalizados.
EmailSubject	String	No	ECS instance	O assunto do e-mail de notificação de alerta.

Response parameters

Parameter	Type	Example	Description
Code	String	200	O código de status HTTP. Nota O valor 200 indica que a chamada foi bem-sucedida.
Message	String	ComparisonOperator is mandatory for this action.	A mensagem retornada. Se a chamada foi bem-sucedida, o valor retornado é null. Em caso de falha, uma mensagem de erro é retornada.
RequestId	String	65D50468-ECEF-48F1-A6E1-D952E89D9432	O ID da requisição.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: a chamada foi bem-sucedida. false: a chamada falhou.

Examples

Exemplos de requisições

http(s)://[Endpoint]/?Action=PutCustomMetricRule
&ComparisonOperator=>=
&ContactGroups=ECS_Group
&EvaluationCount=3
&Level=CRITICAL
&MetricName=cpu_total
&Resources=[{"groupId":7378****,"dimension":"instanceId=i-hp3543t5e4sudb3s****"}]
&RuleId=MyRuleId1
&Statistics=Average
&Threshold=90
&<Common request parameters>

Exemplos de respostas bem-sucedidas

XML format

<PutCustomMetricRuleResponse>
	  <Message></Message>
	  <Code>200</Code>
	  <Success>true</Success>
</PutCustomMetricRuleResponse>

JSON format

{
	"Message": "",
	"Code": "200",
	"Success": true
}

Error codes

Para obter a lista de códigos de erro, acesse o API Error Center.