Tous les produits
Search
Centre de documentation

:DescribeAlertingMetricRuleResources

Dernière mise à jour :Aug 08, 2026

Interroge les ressources pour lesquelles des alertes actives sont déclenchées par une règle d'alerte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. 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

DescribeAlertingMetricRuleResources

Opération à effectuer. Définissez la valeur sur DescribeAlertingMetricRuleResources.

RuleId

String

Non

putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****

ID de la règle d'alerte. Pour savoir comment obtenir l'ID d'une règle d'alerte, consultez DescribeMetricRuleList.

GroupId

String

Non

7671****

ID du groupe d'applications. Pour savoir comment obtenir l'ID d'un groupe d'applications, consultez DescribeMonitorGroups.

Page

Integer

Non

1

Numéro de la page à renvoyer.

Valeur par défaut : 1.

PageSize

Integer

Non

10

Nombre d'entrées à renvoyer par page.

Valeur par défaut : 10.

Namespace

String

Non

acs_mns_new

Espace de noms du service cloud.

Pour en savoir plus sur les espaces de noms des services cloud, consultez Annexe 1 : Métriques.

Dimensions

String

Non

{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}

Dimensions spécifiant les ressources dont vous souhaitez interroger les données de surveillance.

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

Paramètres de réponse

Paramètre Type Exemple Description
Code Integer 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 0724011B-D9E0-4B2F-8C51-F17A894CC42C

ID de la requête.

Total Integer 2

Nombre total d'entrées renvoyées.

Success Boolean true

Indique si l'appel a réussi. Valeurs possibles :

  • true : L'appel a réussi.
  • false : L'appel a échoué.
Resources Array of Resource

Ressources auxquelles la règle d'alerte est appliquée.

Resource
MetricName String ActiveMessages

Nom de la métrique.

RetryTimes String 3

Nombre consécutif de fois où la valeur de la métrique satisfait à la condition d'alerte avant le déclenchement d'une alerte.

MetricValues String {\"timestamp\":1623727500000,\"Sum\":926,\"value\":463,\"Maximum\":463,\"Minimum\":463,\"Average\":463,\"SampleCount\":2,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}

Valeur de la métrique qui a déclenché l'alerte selon la règle d'alerte. La valeur est une chaîne JSON.

Namespace String acs_mns_new

Espace de noms du service cloud.

RuleName String test123456789

Nom de la règle d'alerte.

RuleId String putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****

ID de la règle d'alerte.

ProductCategory String mns

Type de service cloud.

StartTime String 1622427900000

Date et heure d'association de la ressource à la règle d'alerte.

Unité : millisecondes.

Resource String userId=120886317861****,region=cn-huhehaote,queue=test-0128

Ressources surveillées.

LastModifyTime String 1622827900000

Horodatage de la dernière modification de la règle d'alerte.

Unité : millisecondes.

GroupId String 7671****

ID du groupe d'applications.

Remarque Si la règle d'alerte est associée à un groupe d'applications, l'ID du groupe d'applications est renvoyé dans ce paramètre.
Dimensions String {\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\",\"userId\":\"120886317861****\"}

Dimensions spécifiant les ressources dont vous souhaitez interroger les données de surveillance.

LastAlertTime String 1622427900000

Horodatage du dernier déclenchement d'alerte pour la ressource selon la règle d'alerte.

Unité : millisecondes.

Level Integer 3

Niveau de gravité et méthode de notification de l'alerte. Valeurs possibles :

  • 4 : Les notifications d'alerte sont envoyées par e-mail et via des chatbots DingTalk.
  • OK : Aucune alerte n'est générée.
Threshold String 10

Seuil d'alerte.

Statistics String Average

Méthode utilisée pour calculer les valeurs de métrique qui déclenchent les alertes.

Enable String true

Indique si la règle d'alerte est activée. Valeurs possibles :

  • true : La règle d'alerte est activée.
  • false : La règle d'alerte est désactivée.
Escalation Array of Resource

Règle d'alerte sur laquelle le déclenchement de l'alerte est basé.

Resource
ComparisonOperator String GreaterThanOrEqualToThreshold

Opérateur utilisé pour comparer la valeur de la métrique au seuil. Valeurs possibles :

  • 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 du dernier cycle de surveillance
  • LessThanLastPeriod : inférieur à la valeur de la métrique du dernier cycle de surveillance
PreCondition String >=

Opérateur utilisé pour comparer la valeur de la métrique au seuil. Valeurs possibles :

  • >=
  • =
  • <=
  • >
  • <
  • !=
Expression String $Average>=10

Description de la règle d'alerte.

Remarque Ce paramètre correspond au contenu de la règle d'alerte. Une alerte est déclenchée si la valeur de la métrique satisfait à la condition d'alerte.
Times Integer 1

Nombre consécutif de fois où la valeur de la métrique satisfait à la condition d'alerte avant le déclenchement d'une alerte.

Tag String mns

Tags de l'instance.

Threshold String 10

Seuil d'alerte.

Level Integer 3

Niveau de gravité et méthode de notification de l'alerte. Valeurs possibles :

  • 4 : Les notifications d'alerte sont envoyées par e-mail et via des chatbots DingTalk.
  • OK : Aucune alerte n'est générée.
ExpressionListJoin String &&

Relation entre plusieurs métriques. Valeurs possibles :

  • && : CloudMonitor envoie des notifications d'alerte si toutes les métriques satisfont aux conditions d'alerte.
  • || : CloudMonitor envoie des notifications d'alerte si l'une des métriques satisfait aux conditions d'alerte.
ExpressionList Array of ExpressionList

Description de la règle d'alerte multi-métriques.

ExpressionList
ComparisonOperator String GreaterThanOrEqualToThreshold

Opérateur utilisé pour comparer la valeur de la métrique au seuil. Valeurs possibles :

  • 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 du dernier cycle de surveillance
  • LessThanLastPeriod : inférieur à la valeur de la métrique du dernier cycle de surveillance
MetricName String cpu_total

Nom de la métrique.

Period String 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.

Statistics String Average

Méthode statistique du niveau d'alerte. Valeurs possibles :

  • Maximum : valeur maximale
  • Minimum : valeur minimale
  • Average : valeur moyenne
Threshold String 90

Seuil d'alerte.

ExpressionRaw String $Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)

Conditions de déclenchement créées à l'aide d'expressions. Vous pouvez utiliser des expressions pour créer des conditions de déclenchement dans les scénarios suivants :

  • Définir une liste noire d'alertes pour des ressources spécifiques. Par exemple, si vous spécifiez $instanceId != 'i-io8kfvcpp7x5****' && $Average > 50, aucune alerte n'est générée même lorsque la valeur moyenne de la métrique de l'instance i-io8kfvcpp7x5**** dépasse 50.
  • Définir un seuil d'alerte spécial pour une instance spécifiée dans la règle. Par exemple, si vous spécifiez $Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50), une alerte est déclenchée lorsque la valeur moyenne de la métrique de l'instance i-io8kfvcpp7x5**** dépasse 80 ou lorsque la valeur moyenne de la métrique des autres instances dépasse 50.
  • Limiter le nombre d'instances dont les valeurs de métrique dépassent le seuil. Par exemple, si vous spécifiez count($Average > 20) > 3, une alerte est déclenchée uniquement lorsque le nombre d'instances dont la valeur moyenne de la métrique dépasse 20 est supérieur à trois.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=DescribeAlertingMetricRuleResources
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeAlertingMetricRuleResourcesResponse>
	<RequestId>0724011B-D9E0-4B2F-8C51-F17A894CC42C</RequestId>
	<Message></Message>
	<Total>2</Total>
	<Resources>
		<Resource>
			<RuleId>putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****</RuleId>
			<Escalation>
				<Resource>
					<Expression>$Average>=10</Expression>
					<Times>1</Times>
					<Level>3</Level>
					<Tag>mns</Tag>
				</Resource>
			</Escalation>
			<Resource>userId=120886317861****,region=cn-huhehaote,queue=test-0128</Resource>
			<StartTime>1622427900000</StartTime>
			<Dimensions>{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}</Dimensions>
			<MetricValues>{\"timestamp\":1623727500000,\"Sum\":926,\"value\":463,\"Maximum\":463,\"Minimum\":463,\"Average\":463,\"SampleCount\":2,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}</MetricValues>
			<LastModifyTime>1623727904000</LastModifyTime>
			<Statistics>Average</Statistics>
			<Namespace>acs_mns_new</Namespace>
			<GroupId>7671****</GroupId>
			<MetricName>ActiveMessages</MetricName>
			<LastAlertTime>1622427900000</LastAlertTime>
			<ProductCategory>mns</ProductCategory>
			<Enable>true</Enable>
			<Level>3</Level>
			<RuleName>test123456789</RuleName>
			<RetryTimes>1</RetryTimes>
			<Threshold>10</Threshold>
		</Resource>
		<Resource>
			<RuleId>putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****</RuleId>
			<Escalation>
				<Resource>
					<Expression>$Average>=10</Expression>
					<Times>1</Times>
					<Level>3</Level>
					<Tag>mns</Tag>
				</Resource>
			</Escalation>
			<Resource>userId=120886317861****,region=cn-huhehaote,queue=test-022401-1</Resource>
			<StartTime>1622427900000</StartTime>
			<Dimensions>{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-022401-1\"}</Dimensions>
			<MetricValues>{\"timestamp\":1623727500000,\"queue\":\"test-022401-1\",\"Maximum\":349,\"Minimum\":349,\"Sum\":698,\"value\":349,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"Average\":349,\"SampleCount\":2}</MetricValues>
			<LastModifyTime>1623727904000</LastModifyTime>
			<Statistics>Average</Statistics>
			<Namespace>acs_mns_new</Namespace>
			<GroupId>7671****</GroupId>
			<MetricName>ActiveMessages</MetricName>
			<LastAlertTime>1622427900000</LastAlertTime>
			<ProductCategory>mns</ProductCategory>
			<Enable>true</Enable>
			<Level>3</Level>
			<RuleName>test123456789</RuleName>
			<RetryTimes>1</RetryTimes>
			<Threshold>10</Threshold>
		</Resource>
	</Resources>
	<Success>true</Success>
</DescribeAlertingMetricRuleResourcesResponse>

JSON format

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

{
  "RequestId" : "0724011B-D9E0-4B2F-8C51-F17A894CC42C",
  "Message" : "",
  "Total" : 2,
  "Resources" : {
    "Resource" : [ {
      "RuleId" : "putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****",
      "Escalation" : {
        "Resource" : [ {
          "Expression" : "$Average>=10",
          "Times" : 1,
          "Level" : 3,
          "Tag" : "mns"
        } ]
      },
      "Resource" : "userId=120886317861****,region=cn-huhehaote,queue=test-0128",
      "StartTime" : 1622427900000,
      "Dimensions" : "{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}",
      "MetricValues" : "{\"timestamp\":1623727500000,\"Sum\":926,\"value\":463,\"Maximum\":463,\"Minimum\":463,\"Average\":463,\"SampleCount\":2,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}",
      "LastModifyTime" : 1623727904000,
      "Statistics" : "Average",
      "Namespace" : "acs_mns_new",
      "GroupId" : "7671****",
      "MetricName" : "ActiveMessages",
      "LastAlertTime" : 1622427900000,
      "ProductCategory" : "mns",
      "Enable" : true,
      "Level" : 3,
      "RuleName" : "test123456789",
      "RetryTimes" : 1,
      "Threshold" : "10"
    }, {
      "RuleId" : "putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****",
      "Escalation" : {
        "Resource" : [ {
          "Expression" : "$Average>=10",
          "Times" : 1,
          "Level" : 3,
          "Tag" : "mns"
        } ]
      },
      "Resource" : "userId=120886317861****,region=cn-huhehaote,queue=test-022401-1",
      "StartTime" : 1622427900000,
      "Dimensions" : "{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-022401-1\"}",
      "MetricValues" : "{\"timestamp\":1623727500000,\"queue\":\"test-022401-1\",\"Maximum\":349,\"Minimum\":349,\"Sum\":698,\"value\":349,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"Average\":349,\"SampleCount\":2}",
      "LastModifyTime" : 1623727904000,
      "Statistics" : "Average",
      "Namespace" : "acs_mns_new",
      "GroupId" : "7671****",
      "MetricName" : "ActiveMessages",
      "LastAlertTime" : 1622427900000,
      "ProductCategory" : "mns",
      "Enable" : true,
      "Level" : 3,
      "RuleName" : "test123456789",
      "RetryTimes" : 1,
      "Threshold" : "10"
    } ]
  },
  "Success" : true
}

Codes d'erreur

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