CreateLifecycleHook - - Alibaba Cloud Dokümantasyon Merkezi

Bir ölçeklendirme grubunda bir veya daha fazla yaşam döngüsü kancası oluşturur. Yaşam döngüsü kancası, bir örneğin yaşam döngüsündeki kritik aşamalarda (örnek başlatma ve sonlandırma gibi) bildirim gönderme veya betik çalıştırmayı otomatikleştirme gibi özel eylemler yürütmenize olanak tanır. Yaşam döngüsü kancası özelliğini uygulamak, örneklerin daha hassas bir şekilde kontrol edilmesini ve yönetilmesini sağlar. Örneğin, yaşam döngüsü kancaları devreye girdiğinde yapılandırmaları doğrulayabilir, özel görevler ayarlayabilir veya örneklerinizdeki verileri yedekleyebilir, böylece uygulama dağıtımının esnekliğini ve güvenilirliğini artırabilirsiniz.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:CreateLifecycleHook

create

*ScalingGroup

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

None

Request parameters

Parameter	Type	Required	Description	Example
ScalingGroupId	string	Yes	Ölçeklendirme grubunun kimliği.	asg-bp1eyv4qn8ssgv43****
LifecycleHookName	string	No	Yaşam döngüsü kancasının adı. Her yaşam döngüsü kancası adı bir ölçeklendirme grubu içinde benzersiz olmalıdır. Ad 2 ila 64 karakter uzunluğunda olmalı ve harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir. Bir harf veya rakamla başlamalıdır. Bu parametreyi belirtmezseniz, LifecycleHookId parametresinin değeri kullanılır.	lifecyclehook****
LifecycleTransition	string	Yes	Yaşam döngüsü kancasının uygulandığı ölçeklendirme etkinliğinin türü. Geçerli değerler: SCALE_OUT SCALE_IN	SCALE_OUT
DefaultResult	string	No	Yaşam döngüsü kancasının zaman aşımına uğramasından sonra Auto Scaling'in gerçekleştirmesini istediğiniz eylem. Geçerli değerler: CONTINUE: Auto Scaling, ölçek büyütme veya ölçek küçültme isteklerine yanıt vermeye devam eder. ABANDON: Auto Scaling, ölçek büyütme etkinlikleri sırasında oluşturulan Elastic Compute Service (ECS) örneklerini serbest bırakır veya ölçek küçültme etkinlikleri sırasında ECS örneklerini ölçeklendirme grubundan kaldırır. Ölçek küçültme etkinlikleri sırasında bir ölçeklendirme grubundaki birden fazla yaşam döngüsü kancası tetiklenirse ve yaşam döngüsü kancalarından biri için DefaultResult parametresini ABANDON olarak ayarlarsanız, Auto Scaling eylemi DefaultResult değeri ABANDON olarak ayarlanan yaşam döngüsü kancasının zaman aşımına uğramasından hemen sonra gerçekleştirir. Sonuç olarak, diğer yaşam döngüsü kancaları planlanandan önce zaman aşımına uğrar. Diğer durumlarda, Auto Scaling eylemi yalnızca tüm yaşam döngüsü kancaları zaman aşımına uğradıktan sonra gerçekleştirir. Varsayılan değer: CONTINUE.	CONTINUE
HeartbeatTimeout	integer	No	Yaşam döngüsü kancası zaman aşımına uğramadan önceki süre. Yaşam döngüsü kancası zaman aşımına uğradıktan sonra, Auto Scaling varsayılan eylemi gerçekleştirir. Geçerli değerler: 30 ila 21600. Birim: saniye. Bir yaşam döngüsü kancası oluşturduktan sonra, yaşam döngüsü kancasının zaman aşımı süresini uzatmak için RecordLifecycleActionHeartbeat işlemini çağırabilirsiniz. Ayrıca, yaşam döngüsü kancasının zaman aşımı süresini planlanandan önce sonlandırmak için CompleteLifecycleAction işlemini çağırabilirsiniz. Varsayılan değer: 600.	600
NotificationMetadata	string	No	Yaşam döngüsü kancası devreye girdiğinde gönderilen bildirim meta verileri. Bu, bildirimleri verimli bir şekilde yönetmenize ve kategorize etmenize yardımcı olur. Bu parametreyi belirtirseniz, NotificationArn parametresini de belirtmeniz gerekir. Parametre değeri 4.096 karakteri aşamaz. NotificationArn parametresini genel veya özel bir OOS şablonu belirtmek için kullanırsanız, NotificationMetadata parametresinin değeri OOS şablonu parametrelerini içeren bir JSON dizesi olmalıdır. Örneğin, OOS şablonunuz şu parametreleri içerir: `{"dbInstanceId": "dds-bp17661e0135**", "modifyMode": "Append"}`, `dbInstanceId` ve `modifyMode`. OOS şablonunuzda tanımlanan bazı parametrelerin varsayılan değerleri vardır. NotificationMetadata parametresini belirtirken, varsayılan değeri olmayan parametreleri belirtin. Varsayılan değerleri olan parametreleri belirtirseniz, varsayılan değerlerin üzerine yazılır. Ancak, devam eden ölçeklendirme etkinlikleri hakkında bilgi almak için aşağıdaki parametrelerin varsayılan değerleri korunmalıdır: `regionId`: devam eden ölçeklendirme etkinliğinin bölge kimliği. Varsayılan değer: ${regionId}. `instanceIds`: ölçeklendirme etkinliğinde ölçeği küçültülen ECS örneklerinin kimlikleri. Varsayılan değer: ${instanceIds}. `lifecycleHookId`: yaşam döngüsü kancasının kimliği. Varsayılan değer: ${lifecycleHookId}. `lifecycleActionToken`: yaşam döngüsü eyleminin belirteci. Belirteci, yaşam döngüsü kancasının zaman aşımı süresini planlanandan önce sonlandırmak için kullanabilirsiniz. Varsayılan değer: ${lifecycleActionToken} `scalingGroupId`: ölçeklendirme etkinliğinin yürütüldüğü ölçeklendirme grubunun kimliği. Varsayılan değer: ${scalingGroupId}. Not** Şablon parametresi bilgilerini OOS konsolundan alabilirsiniz.	Test lifecycle hook.
NotificationArn	string	No	Bildirim alıcısının Alibaba Cloud Kaynak Adı (ARN). Bu parametreyi belirtmezseniz, yaşam döngüsü kancası devreye girdiğinde herhangi bir bildirim gönderilmez. Bu parametreyi belirtirseniz, değer aşağıdaki biçimlerden birinde olmalıdır: Bildirim alıcısı olarak Simple Message Queue (SMQ, eski adıyla MNS) belirtirseniz, değeri acs:mns:{region-id}:{account-id}:queue/{queuename} biçiminde belirtin. Bildirim alıcısı olarak bir SMQ konusu belirtirseniz, değeri acs:mns:{region-id}:{account-id}:topic/{topicname} biçiminde belirtin. Bildirim alıcısı olarak bir CloudOps Orchestration Service (OOS) şablonu belirtirseniz, değeri acs:oos:{region-id}:{account-id}:template/{templatename} biçiminde belirtin. Bildirim alıcısı olarak bir olay veri yolu belirtirseniz, değeri acs:eventbridge:{region-id}:{account-id}:eventbus/default biçiminde belirtin. Önceki değer biçimlerindeki değişkenler aşağıdaki anlamlara gelir: region-id: ölçeklendirme grubunuzun bölge kimliği. account-id: Alibaba Cloud hesabının kimliği. Resource Access Management (RAM) kullanıcılarının kimlikleri desteklenmez. queuename: SMQ kuyruğunun adı. topicname: SMQ konusunun adı. templatename: OOS şablonunun adı.	acs:mns:cn-beijing:161456884340**:queue/modifyLifecycleHo**

Response elements

Element	Type	Description	Example
	object
RequestId	string	İsteğin kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
LifecycleHookId	string	Yaşam döngüsü kancasının kimliği.	ash-bp1at9ufhmcf9cmy****

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "LifecycleHookId": "ash-bp1at9ufhmcf9cmy****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.