PutCustomMetricRule - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, appelez l'opération PutCustomMetric pour envoyer des données de surveillance personnalisées. Pour plus d'informations, consultez la rubrique PutCustomMetric.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération, car il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	PutCustomMetricRule	Opération à effectuer. Définissez la valeur sur PutCustomMetricRule.
ComparisonOperator	String	Oui	>=	Opérateur de comparaison appliqué au seuil. Valeurs valides : `>=` `=` `<=` `>` `<` `!=`
ContactGroups	String	Oui	ECS_Group	Groupe de contacts destinataire des notifications d'alerte. Séparez plusieurs groupes par des virgules (,).
EvaluationCount	Integer	Oui	3	Nombre consécutif de fois où la valeur de la métrique est mesurée avant le déclenchement d'une alerte.
Level	String	Oui	CRITICAL	Niveau de l'alerte. Valeurs valides : CRITICAL WARN INFO
MetricName	String	Oui	cpu_total	Nom de la métrique. Remarque Pour savoir comment obtenir le nom de la métrique, consultez la rubrique DescribeCustomMetricList.
Resources	String	Oui	[{"groupId":7378**,"dimension":"instanceId=i-hp3543t5e4sudb3s**"}]	Données de surveillance personnalisées auxquelles s'applique la règle d'alerte. La valeur inclut l'ID du groupe d'applications auquel appartiennent les données de surveillance personnalisées ainsi que la dimension associée à la métrique.
RuleId	String	Oui	MyRuleId1	ID de la règle d'alerte. Remarque Spécifiez un ID existant pour modifier la règle d'alerte correspondante ou indiquez un nouvel ID pour créer une règle d'alerte.
Statistics	String	Oui	Average	Méthode de calcul des valeurs de métrique déclenchant les alertes.
Threshold	String	Oui	90	Seuil de la valeur de métrique.
GroupId	String	Non	7378****	ID du groupe d'applications auquel appartiennent les données de surveillance personnalisées. Remarque La valeur 0 indique que les données de surveillance personnalisées envoyées n'appartiennent à aucun groupe d'applications.
RuleName	String	Non	CpuUsage	Nom de la règle d'alerte.
Webhook	String	Non	https://www.aliyun.com	URL de rappel vers laquelle une requête POST est envoyée lorsqu'une alerte est déclenchée par la règle d'alerte.
EffectiveInterval	String	Non	00:00-23:59	Plage horaire pendant laquelle la règle d'alerte est effective. Valeurs valides : de 00:00 à 23:59.
SilenceTime	Integer	Non	86400	Période de silence durant laquelle les notifications ne sont pas renvoyées de manière répétitive pour une même alerte. Unité : secondes. Valeur par défaut : 86400 (soit un jour). Remarque Une seule notification d'alerte est envoyée pendant chaque période de silence, même si la valeur de la métrique dépasse consécutivement le seuil d'alerte à plusieurs reprises.
Period	String	Non	300	Cycle utilisé pour agréger les données de surveillance personnalisées. Unité : secondes. Spécifiez un multiple entier de 60. Le cycle de rapport original des données de surveillance personnalisées est utilisé par défaut.
EmailSubject	String	Non	ECS instance	Objet de l'e-mail de notification d'alerte.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Code d'état HTTP. Remarque La valeur 200 indique que l'appel a réussi.
Message	String	ComparisonOperator is mandatory for this action.	Message renvoyé. Si l'appel aboutit, la valeur de retour est null. En cas d'échec, un message d'erreur est renvoyé.
RequestId	String	65D50468-ECEF-48F1-A6E1-D952E89D9432	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs valides : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

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>

Exemple de réponse en cas de succès

Format XML

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

Format JSON

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.