CreateAlarm - Auto Scaling - Centre de documentation Alibaba Cloud

Crée une tâche déclenchée par événement pour les charges de travail présentant des modèles de trafic irréguliers ou imprévisibles en appelant l'opération CreateAlarm. Une fois la tâche associée aux métriques CloudMonitor, il est possible d'ajuster dynamiquement le nombre d'instances ECS ou ECI dans un groupe de mise à l'échelle et de surveiller les métriques des instances en temps réel afin de mieux gérer et maintenir les ressources cloud.

Description de l'opération

Si vous créez une tâche déclenchée par événement de type surveillance personnalisée (MetricType=custom), vous devez d'abord signaler les données de métriques personnalisées à CloudMonitor. Pour plus d'informations, consultez Tâches déclenchées par événement de surveillance personnalisée.
Lorsque vous créez une tâche déclenchée par événement, vous devez spécifier une métrique (MetricName) et configurer les informations de dimension (Dimensions.DimensionKey et Dimensions.DimensionValue) pour déterminer la portée d'agrégation des données de métrique dans le groupe de mise à l'échelle. Par exemple, vous pouvez spécifier user_id et scaling_group pour agréger les données de métrique de toutes les instances ECS ou ECI pour un utilisateur spécifique dans un groupe de mise à l'échelle spécifique.
- Les métriques pour les tâches déclenchées par événement de surveillance personnalisée (MetricType=custom) dépendent de vos métriques personnalisées.
- Pour plus d'informations sur les métriques prises en charge par les tâches déclenchées par événement de surveillance système (MetricType=system), consultez Tâches déclenchées par événement de surveillance système.

Remarque

Dans les informations de dimension, user_id et scaling_group sont automatiquement renseignés par le système, tandis que device et state doivent être spécifiés manuellement. Pour plus d'informations, consultez les paramètres Dimensions.DimensionKey et Dimensions.DimensionValue.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ess:CreateAlarm

create

*Groupe de mise à l'échelle.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du groupe de mise à l'échelle.	cn-hangzhou
Name	string	Non	Le nom de la tâche déclenchée par événement.	TestAlarmTask
Description	string	Non	La description de la tâche déclenchée par événement.	Test alarm task.
ScalingGroupId	string	Oui	L'identifiant du groupe de mise à l'échelle associé à la tâche déclenchée par événement.	asg-bp18p2yfxow2dloq****
MetricName	string	Non	Le nom de la métrique. Les valeurs valides varient en fonction du type de surveillance de la tâche déclenchée par événement : Si la tâche déclenchée par événement est de type surveillance personnalisée (MetricType=custom), les valeurs valides correspondent à vos métriques personnalisées. Si la tâche déclenchée par événement est de type surveillance système (MetricType=system), valeurs valides : CpuUtilization : l'utilisation du processeur d'une instance ECS (%). ConcurrentConnections : le nombre de connexions simultanées à une instance ECS. IntranetTx : le trafic réseau interne sortant d'une instance ECS (Kb/min). IntranetRx : le trafic réseau interne entrant d'une instance ECS (Kb/min). VpcInternetTx : le trafic Internet sortant d'une instance ECS (Kb/min). VpcInternetRx : le trafic Internet entrant d'une instance ECS (Kb/min). SystemDiskReadBps : le débit de lecture du disque cloud système (Octet/s). SystemDiskWriteBps : le débit d'écriture du disque cloud système (Octet/s). SystemDiskReadOps : les IOPS de lecture du disque cloud système (opérations/s). SystemDiskWriteOps : les IOPS d'écriture du disque cloud système (opérations/s). CpuUtilizationAgent : l'utilisation du processeur surveillée par l'agent (%). GpuUtilizationAgent : l'utilisation du GPU surveillée par l'agent (%). GpuMemoryFreeUtilizationAgent : le pourcentage de mémoire GPU inactive surveillé par l'agent (%). GpuMemoryUtilizationAgent : l'utilisation de la mémoire GPU surveillée par l'agent (%). MemoryUtilization : l'utilisation de la mémoire surveillée par l'agent (%). LoadAverage : la charge moyenne du système surveillée par l'agent. TcpConnection : le nombre total de connexions TCP surveillé par l'agent. TcpConnection : le nombre de connexions TCP établies surveillé par l'agent. PackagesNetOut : le nombre de paquets envoyés par la carte réseau interne par seconde surveillé par l'agent (paquets/s). PackagesNetIn : le nombre de paquets reçus par la carte réseau interne par seconde surveillé par l'agent (paquets/s). PackagesNetOut : le nombre de paquets envoyés par la carte réseau publique par seconde surveillé par l'agent (paquets/s). PackagesNetIn : le nombre de paquets reçus par la carte réseau publique par seconde surveillé par l'agent (paquets/s). EciPodCpuUtilization : l'utilisation du processeur (%). EciPodMemoryUtilization : l'utilisation de la mémoire (%). LoadBalancerRealServerAverageQps : le QPS moyen par serveur backend dans un groupe de serveurs ALB (requêtes/s). Pour plus d'informations, consultez Tâches déclenchées par événement de surveillance système.	CpuUtilization
MetricType	string	Non	Le type de la métrique. Valeurs valides : system : utilise les métriques système de CloudMonitor. custom : utilise les métriques personnalisées signalées à CloudMonitor.	system
Period	integer	Non	La période d'agrégation des données de métriques de surveillance. Unité : secondes. Valeurs valides : 15 60 120 300 900 Remarque Seuls les groupes de mise à l'échelle de type instance ECS prennent en charge une période statistique de 15 secondes. Valeur par défaut : 300.	300
Statistics	string	Non	La méthode d'agrégation des données de métrique. Valeurs valides : Average : la valeur moyenne. Minimum : la valeur minimale. Maximum : la valeur maximale. Valeur par défaut : Average.	Average
Threshold	number	Non	Le seuil des métriques de surveillance. Lorsque l'expression du seuil de surveillance est satisfaite un nombre de fois spécifié, elle déclenche l'exécution d'une règle de mise à l'échelle.	80.0
ComparisonOperator	string	Non	L'opérateur de comparaison utilisé pour comparer la valeur de métrique agrégée au seuil. Cet opérateur spécifie la condition sous laquelle le seuil est atteint. Valeurs valides : Remarque = : La valeur de métrique agrégée est supérieure ou égale au seuil. <= : La valeur de métrique agrégée est inférieure ou égale au seuil. Remarque : La valeur de métrique agrégée est supérieure au seuil. < : La valeur de métrique agrégée est inférieure au seuil. Valeur par défaut : >=.	>=
EvaluationCount	integer	Non	Le nombre de fois que l'expression du seuil doit être satisfaite pour déclencher une règle de mise à l'échelle. Par exemple, si ce paramètre est défini sur 3, la règle de mise à l'échelle est déclenchée lorsque l'utilisation moyenne du processeur est supérieure ou égale à 80 % pendant trois fois consécutives. Valeur par défaut : 3.	3
GroupId	integer	Non	L'identifiant du groupe d'applications CloudMonitor auquel appartient la métrique personnalisée. Ce paramètre est requis uniquement lorsque le type de métrique est custom.	4055401
Effective	string	Non	Spécifie la période d'effet de la tâche déclenchée par événement. Par défaut, la tâche prend effet à tout moment. Ce paramètre suit le format d'expression cron. Le format par défaut est `X X X X X ?`, qui est décrit comme suit : X : un espace réservé pour un champ, représentant les secondes, les minutes, les heures, le jour du mois et le mois dans l'ordre. X peut être une valeur spécifique ou un caractère spécial ayant une signification logique. Pour plus d'informations sur les valeurs valides de X, consultez Expressions Cron. ? : indique qu'aucune valeur n'est spécifiée. Remarque La valeur spécifiée de ce paramètre utilise par défaut le fuseau horaire UTC+8. Vous pouvez ajouter les informations de fuseau horaire `TZ=+yy` avant l'expression cron pour spécifier un fuseau horaire, où y représente le décalage du fuseau horaire. Par exemple, `TZ=+00 * * 1-2 * * ?` indique que la tâche déclenchée par événement prend effet entre 01:00 et 02:59 chaque jour dans le fuseau horaire UTC+0. Exemples et leurs significations : `* * * * * ?` : prend effet à tout moment. `* * 17-18 * * ?` : prend effet entre 17:00 et 18:59 chaque jour dans le fuseau horaire UTC+8. `TZ=+00 * * 1-2 * * ?` : prend effet entre 01:00 et 02:59 chaque jour dans le fuseau horaire UTC+0.	TZ=+00 * * 1-2 * * ?
AlarmActions	array	Non	La liste des identifiants uniques des règles de mise à l'échelle associées à la tâche déclenchée par événement.
	string	Non	La liste des identifiants uniques des règles de mise à l'échelle associées à la tâche déclenchée par événement.	ari:acs:ess:cn-hangzhou:1406926**:scalingrule/asr-bp163l21e07uhn**
Dimensions	array<object>	Non	Les informations de dimension associées à la métrique.
	object	Non	Les informations de dimension associées à la métrique.
DimensionKey	string	Non	La clé des informations de dimension associées à la métrique. Les valeurs valides varient en fonction du type de surveillance de la tâche déclenchée par événement : Si la tâche déclenchée par événement est de type surveillance personnalisée (MetricType=custom), les valeurs valides ne sont pas limitées et peuvent être spécifiées par vos soins. Si la tâche déclenchée par événement est de type surveillance système (MetricType=system), valeurs valides : user_id : l'identifiant de votre compte. scaling_group : le groupe de mise à l'échelle surveillé. device : le type de périphérique de contrôleur d'interface réseau (NIC). state : l'état de la connexion TCP. rulePool : le groupe de serveurs ALB spécifié pour les métriques de surveillance QPS.	device
DimensionValue	string	Non	La valeur des informations de dimension associées à la métrique. Les valeurs valides varient en fonction de Dimensions.DimensionKey : Si Dimensions.DimensionKey est personnalisé, ce qui signifie que la tâche déclenchée par événement est de type surveillance personnalisée (MetricType=custom), les valeurs valides ne sont pas limitées et peuvent être spécifiées par vos soins. Si Dimensions.DimensionKey se situe dans la plage spécifiée par le système, ce qui signifie que la tâche déclenchée par événement est de type surveillance système (MetricType=system), valeurs valides : user_id : automatiquement renseigné par le système. scaling_group : automatiquement renseigné par le système. device : eth0 : Pour les instances de réseau classique, eth0 représente la carte réseau interne. Pour les instances connectées à un VPC, seule la carte réseau eth0 existe. eth1 : Pour les instances de réseau classique, eth1 représente la carte réseau publique. state : TCP_TOTAL : le nombre total de connexions TCP. ESTABLISHED : le nombre de connexions TCP établies. rulePool : l'identifiant du groupe de serveurs ALB. Exemple : sgp-xxxxx.	eth0
Expressions	array<object>	Non	Les informations relatives à la règle d'alerte multi-métrique.
	object	Non	Les informations relatives à la règle d'alerte multi-métrique.
MetricName	string	Non	Le nom des métriques de surveillance pour la règle d'alerte multi-métrique. Les valeurs valides varient en fonction du type de surveillance de la tâche déclenchée par événement : Si la tâche déclenchée par événement est de type surveillance personnalisée (MetricType=custom), les valeurs valides correspondent à vos métriques personnalisées. Si la tâche déclenchée par événement est de type surveillance système (MetricType=system), valeurs valides : CpuUtilization : l'utilisation du processeur d'une instance ECS (%). ConcurrentConnections : le nombre de connexions simultanées à une instance ECS. IntranetTx : le trafic réseau interne sortant d'une instance ECS (Kb/min). IntranetRx : le trafic réseau interne entrant d'une instance ECS (Kb/min). VpcInternetTx : le trafic Internet sortant d'une instance ECS (Kb/min). VpcInternetRx : le trafic Internet entrant d'une instance ECS (Kb/min). SystemDiskReadBps : le débit de lecture du disque cloud système (Octet/s). SystemDiskWriteBps : le débit d'écriture du disque cloud système (Octet/s). SystemDiskReadOps : les IOPS de lecture du disque cloud système (opérations/s). SystemDiskWriteOps : les IOPS d'écriture du disque cloud système (opérations/s). CpuUtilizationAgent : l'utilisation du processeur surveillée par l'agent (%). GpuUtilizationAgent : l'utilisation du GPU surveillée par l'agent (%). GpuMemoryFreeUtilizationAgent : le pourcentage de mémoire GPU inactive surveillé par l'agent (%). GpuMemoryUtilizationAgent : l'utilisation de la mémoire GPU surveillée par l'agent (%). MemoryUtilization : l'utilisation de la mémoire surveillée par l'agent (%). LoadAverage : la charge moyenne du système surveillée par l'agent. TcpConnection : le nombre total de connexions TCP surveillé par l'agent. TcpConnection : le nombre de connexions TCP établies surveillé par l'agent. PackagesNetOut : le nombre de paquets envoyés par le contrôleur d'interface réseau (NIC) interne par seconde surveillé par l'agent (paquets/s). PackagesNetIn : le nombre de paquets reçus par le contrôleur d'interface réseau (NIC) interne par seconde surveillé par l'agent (paquets/s). PackagesNetOut : le nombre de paquets envoyés par le contrôleur d'interface réseau (NIC) public par seconde surveillé par l'agent (paquets/s). PackagesNetIn : le nombre de paquets reçus par le contrôleur d'interface réseau (NIC) public par seconde surveillé par l'agent (paquets/s). EciPodCpuUtilization : l'utilisation du processeur (%). EciPodMemoryUtilization : l'utilisation de la mémoire (%). LoadBalancerRealServerAverageQps : le QPS moyen par serveur backend dans un groupe de serveurs ALB (requêtes/s). Pour plus d'informations, consultez Tâches déclenchées par événement de surveillance système.	CpuUtilization
ComparisonOperator	string	Non	L'opérateur de comparaison utilisé pour comparer la valeur de métrique agrégée au seuil pour la règle d'alerte multi-métrique. Cet opérateur spécifie la condition sous laquelle le seuil est atteint. Valeurs valides : Remarque = : La valeur de métrique agrégée est supérieure ou égale au seuil. <= : La valeur de métrique agrégée est inférieure ou égale au seuil. Remarque : La valeur de métrique agrégée est supérieure au seuil. < : La valeur de métrique agrégée est inférieure au seuil. Valeur par défaut : >=.	>=
Period	integer	Non	La période d'agrégation des données de métriques de surveillance dans la règle d'alerte multi-métrique. Unité : secondes. Valeurs valides : 15 60 120 300 900 Remarque Seuls les groupes de mise à l'échelle de type instance ECS prennent en charge une période statistique de 15 secondes. Valeur par défaut : 300.	900
Statistics	string	Non	La méthode d'agrégation des données de métrique dans la règle d'alerte multi-métrique. Valeurs valides : Average : la valeur moyenne. Minimum : la valeur minimale. Maximum : la valeur maximale. Valeur par défaut : Average.	Average
Threshold	number	Non	Le seuil des métriques de surveillance dans la règle d'alerte multi-métrique. Lorsque l'expression du seuil de surveillance est satisfaite un nombre de fois spécifié, elle déclenche l'exécution d'une règle de mise à l'échelle.	40.0
ExpressionsLogicOperator	string	Non	L'opérateur logique entre plusieurs conditions d'alerte de métrique. Valeurs valides : `&&` : Une alerte est déclenchée uniquement lorsque toutes les métriques de surveillance satisfont aux conditions d'alerte. Autrement dit, une alerte est déclenchée uniquement lorsque toutes les expressions de la règle d'alerte multi-métrique sont évaluées à `true`. `\|\|` : Une alerte est déclenchée si l'une des métriques satisfait à la condition d'alerte. Valeur par défaut : `&&`.	&&

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse pour la création d'une tâche déclenchée par événement.
AlarmTaskId	string	L'identifiant de la tâche déclenchée par événement.	asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1**
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Exemples

JSON format

{
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.