Tüm Ürünler
Search
Belge Merkezi

:DescribeLifecycleHooks

Son Güncelleme:Oct 02, 2026

Yaşam döngüsü kancalarını sorgular. Bu işlemi çağırırken, yaşam döngüsü kancası zaman aşımına uğradığında gerçekleştirilecek varsayılan eylem, yaşam döngüsü kancasıyla ilişkili ölçeklendirme etkinliği, bildirim alıcısının Alibaba Cloud Kaynak Adı (ARN) ve yaşam döngüsü kancasının geçerlilik süresi gibi istenen yaşam döngüsü kancasının ayrıntılarını sorgulamak için yaşam döngüsü kancası kimliğini veya ölçeklendirme grubu kimliğini belirtebilirsiniz.

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:DescribeLifecycleHooks

get

*ScalingGroup

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

None None

Request parameters

Parameter

Type

Required

Description

Example

ScalingGroupId

string

No

Ölçeklendirme grubunun kimliği.

asg-bp1igpak5ft1flyp****

LifecycleHookName

string

No

Yaşam döngüsü kancasının adı.

lifecyclehook****

PageNumber

integer

No

Döndürülecek sayfanın numarası. Sayfalar 1'den başlar.

Varsayılan değer: 1.

1

PageSize

integer

No

Her sayfada döndürülecek giriş sayısı. Maksimum değer: 50.

Varsayılan değer: 50.

50

LifecycleHookIds

array

No

Sorgulamak istediğiniz yaşam döngüsü kancalarının kimlikleri.

string

No

Sorgulamak istediğiniz yaşam döngüsü kancasının kimliği.

ash-bp1at9ufhmcf9cmy****

RegionId

string

No

Ölçeklendirme grubunun bölge kimliği.

cn-beijing

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

RequestId

string

İsteğin kimliği.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

PageNumber

integer

Döndürülen sayfanın sayfa numarası.

1

PageSize

integer

Sayfa başına döndürülen giriş sayısı.

50

TotalCount

integer

Yaşam döngüsü kancalarının toplam sayısı.

1

LifecycleHooks

array<object>

Yaşam döngüsü kancalarıyla ilgili ayrıntılar.

object

Yaşam döngüsü kancasıyla ilgili ayrıntılar.

DefaultResult

string

Yaşam döngüsü kancası zaman aşımına uğradıktan sonra gerçekleştirilen sonraki eylem.

CONTINUE

LifecycleHookId

string

Yaşam döngüsü kancasının kimliği.

ash-bp19d1032y9kij96****

LifecycleHookName

string

Yaşam döngüsü kancasının adı.

lifecyclehook****

LifecycleTransition

string

Yaşam döngüsü kancasının uygulandığı ölçeklendirme etkinliğinin türü.

SCALE_OUT

NotificationMetadata

string

Yaşam döngüsü kancası devreye girdiğinde Auto Scaling'in gönderdiği bir bildirime dahil edilen sabit dize.

Test Lifecycle Hook.

NotificationArn

string

Yaşam döngüsü kancası devreye girdiğinde bildirim alıcısının ARN'si. Bu parametrenin değeri aşağıdaki biçimlerden birinde olmalıdır:

  • Bir bildirim kuralı oluşturmazsanız, değeri acs:ess:{region-id}:{account-id}:null/null biçiminde belirtin.

  • Bildirim alıcısı olarak Basit Mesaj Kuyruğu (SMQ, eski adıyla MNS) kuyruğu belirtirseniz, değeri acs:mns:{region-id}:{account-id}:queue/{queuename} biçiminde belirtin.

  • Bildirim alıcısı olarak SMQ belirtirseniz, değeri acs:mns:{region-id}:{account-id}:topic/{topicname} biçiminde belirtin.

  • Bildirim alıcısı olarak 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.

Yukarıdaki 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ızın kimliği.

  • queuename: SMQ kuyruğunun adı.

  • topicname: SMQ konusunun adı.

  • templatename: OOS şablonunun adı.

acs:ess:cn-beijing:161456884340****:null/null

HeartbeatTimeout

integer

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ığında, Auto Scaling DefaultResult tarafından belirtilen eylemi gerçekleştirir.

60

ScalingGroupId

string

Ölçeklendirme grubunun kimliği.

asg-bp1igpak5ft1flyp****

LifecycleHookStatus

string

Yaşam döngüsü kancasının durumu. Geçerli değerler:

  • Active: Yaşam döngüsü kancası etkindir.

  • InActive: Yaşam döngüsü kancası devre dışıdır.

Active

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "LifecycleHooks": [
    {
      "DefaultResult": "CONTINUE",
      "LifecycleHookId": "ash-bp19d1032y9kij96****",
      "LifecycleHookName": "lifecyclehook****",
      "LifecycleTransition": "SCALE_OUT",
      "NotificationMetadata": "Test Lifecycle Hook.",
      "NotificationArn": "acs:ess:cn-beijing:161456884340****:null/null",
      "HeartbeatTimeout": 60,
      "ScalingGroupId": "asg-bp1igpak5ft1flyp****",
      "LifecycleHookStatus": "Active"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.