Crée un ou plusieurs hooks de cycle de vie pour un groupe de mise à l'échelle.
Description de l'opération
Description de l'opération
-
Un groupe de mise à l'échelle peut avoir un maximum de 6 hooks de cycle de vie. Lorsqu'une activité de mise à l'échelle se produit dans un groupe de mise à l'échelle doté de hooks de cycle de vie, ces derniers suspendent l'activité de mise à l'échelle pendant une période d'attente. Vous pouvez spécifier la période d'attente à l'aide du paramètre HeartbeatTimeout. Pendant cette période d'attente, vous pouvez effectuer des opérations telles que l'initialisation des configurations d'instances ECS et la récupération des données des instances ECS.
-
Lors d'une activité de montée en charge, les instances ECS entrent dans l'état d'attente après avoir été ajoutées à la liste blanche de l'instance RDS, et sont ajoutées au groupe de serveurs backend de l'instance SLB une fois l'état d'attente terminé. Lors d'une activité de descente en charge, les instances ECS entrent dans l'état d'attente après avoir été retirées du groupe de serveurs backend de l'instance SLB, et sont retirées de la liste blanche de l'instance RDS une fois l'état d'attente terminé.
-
Vous pouvez configurer des méthodes de notification pour les hooks de cycle de vie. Les méthodes de notification prises en charge incluent les sujets MNS, les files d'attente MNS et les modèles OOS. Si vous configurez un modèle OOS, créez un rôle RAM pour le service OOS. Pour plus d'informations, consultez Configuration des autorisations RAM pour OOS.
Si le groupe de mise à l'échelle contient des instances ECS existantes et que le modèle OOS configuré est utilisé pour ajouter ou supprimer des instances de la liste blanche d'une base de données autre que RDS, vous devez ajouter manuellement les instances ECS existantes à la liste blanche de la base de données.
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
|
ess:CreateLifecycleHook |
create |
*ScalingGroup
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| ScalingGroupId |
string |
Oui |
L'identifiant du groupe de mise à l'échelle. |
asg-bp1eyv4qn8ssgv43**** |
| LifecycleHookName |
string |
Non |
Le nom du hook de cycle de vie. Le nom doit être unique au sein du groupe de mise à l'échelle. Le nom doit comporter entre 2 et 64 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). Le nom doit commencer par une lettre, un chiffre ou un caractère chinois. Valeur par défaut : la valeur de LifecycleHookId. |
lifecyclehook**** |
| LifecycleTransition |
string |
Oui |
Le type d'activité de mise à l'échelle auquel le hook de cycle de vie s'applique. Valeurs valides :
|
SCALE_OUT |
| DefaultResult |
string |
Non |
L'action à entreprendre une fois l'état d'attente terminé. Valeurs valides :
Lorsqu'une activité de descente en charge (SCALE_IN) déclenche plusieurs hooks de cycle de vie dans un groupe de mise à l'échelle, si le DefaultResult d'un hook de cycle de vie est défini sur ABANDON ou ROLLBACK et que l'état d'attente de ce hook se termine, les états d'attente des autres hooks de cycle de vie se terminent prématurément. Dans les autres cas, l'action à entreprendre est déterminée par le dernier hook de cycle de vie dont l'état d'attente se termine. Valeur par défaut : CONTINUE. |
CONTINUE |
| HeartbeatTimeout |
integer |
Non |
La période d'attente définie par le hook de cycle de vie pour l'activité du groupe de mise à l'échelle. Une fois l'état d'attente expiré, l'action suivante est exécutée. Valeurs valides : 30 à 21600. Unité : secondes. Une fois un hook de cycle de vie créé, vous pouvez appeler RecordLifecycleActionHeartbeat pour prolonger la période d'attente d'une instance ECS, ou appeler CompleteLifecycleAction pour mettre fin prématurément à l'état d'attente d'une activité de mise à l'échelle. Valeur par défaut : 600. |
600 |
| NotificationMetadata |
string |
Non |
Les informations de notification qui sont transmises à NotificationArn (le destinataire de la notification) lorsque le hook de cycle de vie suspend une activité de mise à l'échelle. Ce paramètre vous aide à gérer et à baliser les informations de notification de différentes catégories. Vous devez également spécifier NotificationArn. La valeur peut comporter jusqu'à 4 096 caractères. Si NotificationArn est défini sur un modèle OOS, qu'il s'agisse d'un modèle public ou personnalisé, NotificationMetadata doit être défini sur une chaîne JSON correspondant aux paramètres du modèle OOS. Par exemple,
Remarque
|
Test de hook de cycle de vie |
| NotificationArn |
string |
Non |
L'Alibaba Cloud Resource Name (ARN) du destinataire de la notification du hook de cycle de vie. Si ce paramètre n'est pas défini, aucune notification n'est envoyée. Les méthodes de notification suivantes sont prises en charge lorsque vous définissez ce paramètre :
Les variables dans le format ont les significations suivantes :
|
acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo**** |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| RequestId |
string |
L'identifiant de la requête. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| LifecycleHookId |
string |
L'identifiant du hook de cycle de vie. |
ash-bp1at9ufhmcf9cmy**** |
Exemples
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"LifecycleHookId": "ash-bp1at9ufhmcf9cmy****"
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.