Crée une tâche déclenchée par un événement pour un groupe de mise à l'échelle. Une fois la métrique Cloud Monitor associée à la tâche, Auto Scaling ajuste dynamiquement le nombre d'instances ECS ou d'instances de conteneur élastiques en fonction des données de métriques en temps réel.
Notes d'utilisation
Si vous créez une tâche de surveillance personnalisée (MetricType=custom), commencez par envoyer vos métriques personnalisées à Cloud Monitor. Tâches déclenchées par des événements pour la surveillance personnalisée.
-
Spécifiez la métrique (MetricName) et les dimensions (Dimension.N.DimensionKey et Dimension.N.DimensionValue) pour définir la portée d'agrégation des métriques. Par exemple,
user_idetscaling_groupagrègent les données de métriques pour toutes les instances d'un utilisateur et d'un groupe de mise à l'échelle spécifiques.Surveillance personnalisée (MetricType=custom) : les métriques dépendent de vos métriques de surveillance personnalisées.
Surveillance système (MetricType=system) : Tâches déclenchées par des événements pour la surveillance système.
Les dimensions user_id et scaling_group sont renseignées automatiquement. Spécifiez manuellement device et state. Consultez les descriptions des paramètres Dimension.N.DimensionKey et Dimension.N.DimensionValue.
Tester l'opération
Paramètres de requête
|
Parameter |
Type |
Required |
Example |
Description |
|
Action |
String |
Yes |
CreateAlarm |
Définissez la valeur sur CreateAlarm. |
|
RegionId |
String |
Yes |
cn-hangzhou |
L'ID de région du groupe de mise à l'échelle. |
|
Name |
String |
No |
TestAlarmTask |
Le nom de la tâche. |
|
Description |
String |
No |
Test alarm task. |
La description de la tâche. |
|
ScalingGroupId |
String |
Yes |
asg-bp18p2yfxow2dloq**** |
L'ID du groupe de mise à l'échelle pour la tâche. |
|
MetricName |
String |
No |
CpuUtilization |
Le nom de la métrique. Les valeurs valides dépendent du type de métrique.
Tâches déclenchées par des événements pour la surveillance système. |
|
MetricType |
String |
No |
system |
Le type de métrique. Valeurs valides :
|
|
Period |
Integer |
No |
300 |
La période statistique de la métrique, en secondes. Valeurs valides :
Remarque
Une période statistique de 15 secondes est prise en charge uniquement pour les groupes de mise à l'échelle de type ECS. Valeur par défaut : 300. |
|
Statistics |
String |
No |
Average |
La méthode d'agrégation des métriques. Valeurs valides :
Valeur par défaut : Average. |
|
Threshold |
Float |
No |
80.0 |
Le seuil de la métrique. Une règle de mise à l'échelle s'exécute lorsque ce seuil est atteint pendant le nombre spécifié de fois consécutives. |
|
ComparisonOperator |
String |
No |
>= |
L'opérateur permettant de comparer la valeur de la métrique au seuil. Valeurs valides :
Valeur par défaut : >=. |
|
EvaluationCount |
Integer |
No |
3 |
Le nombre de fois consécutives où le seuil doit être atteint avant qu'une règle de mise à l'échelle ne s'exécute. Par exemple, 3 signifie que la règle s'exécute uniquement si l'utilisation moyenne du CPU est ≥ 80 % pendant trois périodes consécutives. Valeur par défaut : 3. |
|
GroupId |
Integer |
No |
4055401 |
L'ID du groupe d'applications Cloud Monitor pour la métrique personnalisée. Requis uniquement lorsque MetricType est défini sur custom. |
|
Effective |
String |
No |
TZ=+00 1-2 ? |
La période d'efficacité de la tâche. Par défaut : toujours actif. Utilise une expression cron au format
Remarque
Par défaut, UTC+8. Ajoutez Exemples de valeurs :
|
|
AlarmAction.N |
String |
No |
ari:acs:ess:cn-hangzhou:1406926**:scalingrule/asr-bp163l21e07uhn** |
L'identifiant unique de la règle de mise à l'échelle N associée à la tâche. |
|
Dimension.N.DimensionKey |
String |
No |
device |
La clé de dimension pour la métrique N. Les valeurs valides dépendent du type de métrique.
|
|
Dimension.N.DimensionValue |
String |
No |
eth0 |
La valeur de dimension pour la métrique N. Les valeurs valides dépendent de Dimension.N.DimensionKey.
|
|
Expression.N.MetricName |
String |
No |
CpuUtilization |
Le nom de la métrique pour l'expression N dans une règle d'alerte multi-métriques. Les valeurs valides dépendent du type de métrique.
Tâches déclenchées par des événements pour la surveillance système. |
|
Expression.N.ComparisonOperator |
String |
No |
>= |
L'opérateur permettant de comparer la valeur de la métrique au seuil dans une règle d'alerte multi-métriques. Valeurs valides :
Valeur par défaut : >=. |
|
Expression.N.Period |
Integer |
No |
900 |
La période statistique pour la métrique N dans une règle d'alerte multi-métriques, en secondes. Valeurs valides :
Remarque
Une période statistique de 15 secondes est prise en charge uniquement pour les groupes de mise à l'échelle de type ECS. Valeur par défaut : 300. |
|
Expression.N.Statistics |
String |
No |
Average |
La méthode d'agrégation pour la métrique N dans une règle d'alerte multi-métriques. Valeurs valides :
Valeur par défaut : Average. |
|
Expression.N.Threshold |
Float |
No |
40.0 |
Le seuil pour la métrique N dans une règle d'alerte multi-métriques. Une règle de mise à l'échelle s'exécute lorsque ce seuil est atteint pendant le nombre spécifié de fois consécutives. |
|
ExpressionsLogicOperator |
String |
No |
&& |
L'opérateur logique entre les conditions dans une règle d'alerte multi-métriques. Valeurs valides :
Valeur par défaut : |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
AlarmTaskId |
String |
asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1** |
L'ID de la tâche. |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
L'ID de la requête. |
Exemples
Exemple de requête
http(s)://ess.aliyuncs.com/?Action=CreateAlarm
&RegionId=cn-hangzhou
&Name=TestAlarmTask
&Description=Test alarm task.
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&MetricName=CpuUtilization
&MetricType=system
&Period=300
&Statistics=Average
&Threshold=80.0
&ComparisonOperator=>=
&EvaluationCount=3
&GroupId=4055401
&Effective=TZ=+00 * * 1-2 * * ?
&AlarmAction=["ari:acs:ess:cn-hangzhou:1406926****:scalingrule/asr-bp163l21e07uhn****"]
&Dimension=[{"DimensionKey":"device","DimensionValue":"eth0"}]
&Expression=[{"MetricName":"CpuUtilization","ComparisonOperator":">=","Period":900,"Statistics":"Average","Threshold":40.0}]
&ExpressionsLogicOperator=&&
&Common request parametersExemple de réponse
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateAlarmResponse>
<AlarmTaskId>asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****</AlarmTaskId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateAlarmResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"AlarmTaskId" : "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}Codes d'erreur
Pour plus de codes d'erreur, consultez le Centre d'erreurs.
|
HTTP status code |
Error code |
Error message |
Description |
|
404 |
InvalidParameter |
The specified value of parameter "%s" is not valid. |
La valeur du paramètre %s n'est pas valide. |