PutResourceMetricRules - - Centre de documentation Alibaba Cloud

Cette rubrique présente un exemple de création d'une règle d'alerte déclenchée par seuil pour la métrique cpu_total d'une instance Elastic Compute Service (ECS) dont l'ID est i-uf6j91r34rnwawoo****. Le namespace d'ECS est acs_ecs_dashboard. Le groupe de contacts d'alerte associé à la règle est ECS_Group. Le nom de la règle d'alerte est test123. L'ID de la règle d'alerte est a151cd6023eacee2f0978e03863cc1697c89508****. La méthode statistique appliquée aux alertes de niveau Critical est Average. L'opérateur de comparaison utilisé pour les alertes de niveau Critical est GreaterThanOrEqualToThreshold. Le seuil défini pour les alertes de niveau Critical est 90. Le nombre de fois consécutives où la valeur de la métrique doit satisfaire la condition de déclenchement avant l'émission d'une alerte de niveau Critical est de 3.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer 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	PutResourceMetricRules	Opération à effectuer. Définissez la valeur sur PutResourceMetricRules.
Rules.N.Escalations.Info.Threshold	String	Non	90	Seuil pour les alertes de niveau Info. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.MetricName	String	Non	cpu_total	Nom de la métrique. Valeurs valides pour N : 1 à 500. Pour savoir comment interroger le nom d'une métrique, consultez l'Annexe 1 : Métriques.
Rules.N.Escalations.Warn.Threshold	String	Non	90	Seuil pour les alertes de niveau Warn. Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.EffectiveInterval	String	Non	00:00-23:59	Période durant laquelle la règle d'alerte est effective. Valeurs valides pour N : 1 à 500.
Rules.N.NoEffectiveInterval	String	Non	00:00-06:00	Période durant laquelle la règle d'alerte n'est pas effective. Valeurs valides pour N : 1 à 500.
Rules.N.RuleId	String	Oui	a151cd6023eacee2f0978e03863cc1697c89508****	ID de la règle d'alerte. Valeurs valides pour N : 1 à 500. Spécifiez un nouvel ID ou l'ID d'une règle d'alerte existante. Pour savoir comment interroger l'ID d'une règle d'alerte, consultez DescribeMetricRuleList. Remarque Si vous spécifiez un nouvel ID, une règle d'alerte déclenchée par seuil est créée.
Rules.N.Escalations.Critical.Times	Integer	Non	3	Nombre de fois consécutives où la valeur de la métrique doit satisfaire la condition d'alerte avant le déclenchement d'une alerte de niveau Critical. Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Critical.Threshold	String	Non	90	Seuil pour les alertes de niveau Critical. Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Critical.Statistics	String	Non	Average	Méthodes statistiques pour les alertes de niveau Critical. Valeurs valides pour N : 1 à 500. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. Les valeurs possibles sont Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez l'Annexe 1 : Métriques. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Warn.ComparisonOperator	String	Non	GreaterThanOrEqualToThreshold	Opérateur utilisé pour comparer la valeur de la métrique au seuil pour les alertes de niveau Warn. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique lors du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique lors du dernier cycle de surveillance Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Info.Times	Integer	Non	3	Nombre de fois consécutives où la valeur de la métrique doit satisfaire la condition d'alerte avant le déclenchement d'une alerte de niveau Info. Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Resources	String	Oui	[{"instanceId":"i-uf6j91r34rnwawoo****"}]	Informations relatives à la ressource. Exemples : `[{"instanceId":"i-uf6j91r34rnwawoo"}]` et `[{"userId":"100931896542"}]`. Valeurs valides pour N : 1 à 500. Pour plus d'informations sur les dimensions prises en charge pour interroger les ressources, consultez l'Annexe 1 : Métriques.
Rules.N.SilenceTime	Integer	Non	86400	Période de silence pendant laquelle aucune nouvelle notification d'alerte n'est envoyée, même si les conditions de déclenchement sont remplies. Unité : secondes. Valeur par défaut : 86400. Valeurs valides pour N : 1 à 500. Remarque Si une alerte n'est pas résolue à l'issue de la période de silence, CloudMonitor renvoie une notification d'alerte.
Rules.N.Webhook	String	Non	https://alert.aliyun.com.com:8080/callback	URL de rappel vers laquelle une requête POST est envoyée lorsqu'une alerte est déclenchée selon la règle d'alerte. Valeurs valides pour N : 1 à 500.
Rules.N.ContactGroups	String	Oui	ECS_Group	Groupes de contacts d'alerte. Les notifications d'alerte sont envoyées aux contacts figurant dans le groupe de contacts d'alerte. Valeurs valides pour N : 1 à 500. Remarque Un groupe de contacts d'alerte peut contenir un ou plusieurs contacts d'alerte. Pour savoir comment créer des contacts et des groupes de contacts d'alerte, consultez PutContact et PutContactGroup.
Rules.N.Namespace	String	Oui	acs_ecs_dashboard	Namespace du service cloud. Valeurs valides pour N : 1 à 500. Pour savoir comment interroger le namespace d'un service cloud, consultez l'Annexe 1 : Métriques.
Rules.N.EmailSubject	String	Non	Alert for an ECS instance	Objet de l'e-mail de notification d'alerte. Valeurs valides pour N : 1 à 500.
Rules.N.Period	String	Non	60	Période statistique de la métrique. Unité : secondes. La valeur par défaut correspond à l'intervalle de collecte des données de surveillance de la métrique. Valeurs valides pour N : 1 à 500. Remarque Pour savoir comment interroger la période statistique d'une métrique, consultez l'Annexe 1 : Métriques.
Rules.N.RuleName	String	Oui	test123	Nom de la règle d'alerte. Valeurs valides pour N : 1 à 500. Spécifiez un nouveau nom ou le nom d'une règle d'alerte existante. Pour savoir comment interroger le nom d'une règle d'alerte, consultez DescribeMetricRuleList. Remarque Si vous spécifiez un nouveau nom, une règle d'alerte déclenchée par seuil est créée.
Rules.N.Escalations.Info.Statistics	String	Non	Average	Méthodes statistiques pour les alertes de niveau Info. Valeurs valides pour N : 1 à 500. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. Les valeurs possibles sont Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez l'Annexe 1 : Métriques. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Warn.Times	Integer	Non	3	Nombre de fois consécutives où la valeur de la métrique doit satisfaire la condition d'alerte avant le déclenchement d'une alerte de niveau Warn. Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Info.ComparisonOperator	String	Non	GreaterThanOrEqualToThreshold	Opérateur de comparaison du seuil pour les alertes de niveau Info. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique lors du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique lors du dernier cycle de surveillance Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Interval	String	Non	60	Intervalle de déclenchement des alertes basé sur la règle d'alerte. Unité : secondes. Valeurs valides pour N : 1 à 500. Remarque Pour savoir comment interroger la période statistique d'une métrique, consultez l'Annexe 1 : Métriques.
Rules.N.Escalations.Critical.ComparisonOperator	String	Non	GreaterThanOrEqualToThreshold	Opérateur utilisé pour comparer la valeur de la métrique au seuil pour les alertes de niveau Critical. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique lors du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique lors du dernier cycle de surveillance Valeurs valides pour N : 1 à 500. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.Escalations.Warn.Statistics	String	Non	Average	Méthodes statistiques pour les alertes de niveau Warn. Valeurs valides pour N : 1 à 500. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. Les valeurs possibles sont Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez l'Annexe 1 : Métriques. Remarque Sélectionnez au moins un niveau d'alerte parmi Critical, Warn et Info, puis spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau sélectionné.
Rules.N.NoDataPolicy	String	Non	KEEP_LAST_STATE	Méthode utilisée pour gérer les alertes en l'absence de données de surveillance. Valeurs valides : KEEP_LAST_STATE (valeur par défaut) : aucune action n'est effectuée. INSUFFICIENT_DATA : une alerte dont le contenu est « Insufficient data » est déclenchée. OK : le statut est considéré comme normal. Valeurs valides pour N : 1 à 500.
Rules.N.Labels.N.Key	String	Non	tagKey1	Clé du tag.
Rules.N.Labels.N.Value	String	Non	ECS	Valeur du tag. Remarque Utilisez un paramètre de modèle pour spécifier une valeur de tag. CloudMonitor remplace la valeur du paramètre de modèle par la valeur réelle du tag.

Pour plus d'informations sur les paramètres de requête communs, consultez les Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.
Message	String	The request processing has failed due to some unknown error.	Message d'erreur.
RequestId	String	15D1440E-BF24-5A41-93E4-36864635179E	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é.
FailedListResult	Array of Target		Règles d'alerte dont la création a échoué pour la ressource.
Target
RuleId	String	a151cd6023eacee2f0978e03863cc1697c89508****	ID de la règle d'alerte.
Result	Object		Règle d'alerte dont la création a échoué.
Code	String	404	Code d'état.
Message	String	The request processing has failed due to some unknown error.	Message d'erreur.
Success	Boolean	false	Indique si l'appel a réussi. Valeurs valides : true : l'appel a réussi. false : l'appel a échoué.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

Format 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>

Format JSON

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

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.