Auto Scaling：CreateLifecycleHook

目標伸縮組的 ID。

生命週期掛鉤的名稱。不能與當前伸縮組其他生命週期掛鉤重名，長度為 2~64 個英文或中文字元，以數字、大小寫字母或中文開頭，可包含數字、底線（_）、短劃線（-）和半形句號（.）。

預設值為 LifecycleHookId 的值。

生命週期掛鉤適用的伸縮活動類型。取值範圍：

• SCALE_OUT：伸縮組彈性擴張活動。

• SCALE_IN：伸縮組彈性收縮活動。

等待狀態結束後的下一步動作。取值範圍：

• CONTINUE：繼續回應彈性擴張活動或者繼續回應彈性收縮活動。

• ABANDON：直接釋放彈性擴張活動建立出來的 ECS 執行個體或者直接將彈性收縮活動中的 ECS 執行個體從伸縮組移除。

• ROLLBACK：針對彈性收縮活動，會拒絕釋放 ECS 執行個體，進行回滾；針對彈性擴張活動，會直接釋放建立出來的 ECS 執行個體，效果同ABANDON一樣。

當伸縮組發生彈性收縮活動（SCALE_IN）並觸發多個生命週期掛鉤時，如果一個生命週期掛鉤的DefaultResult取值為ABANDON或ROLLBACK，且該掛鉤等待狀態結束時，會提前將其他生命週期掛鉤對應的等待狀態提前結束。其他情況下，下一步動作均以最後一個結束等待狀態的下一步動作為準。

預設值：CONTINUE。

生命週期掛鉤為伸縮組活動設定的等待時間，等待狀態逾時後會執行下一步動作。取值範圍：30~21600，單位：秒。

建立了生命週期掛鉤後，您可以呼叫 RecordLifecycleActionHeartbeat 延長 ECS 執行個體的等待時間，也可以呼叫 CompleteLifecycleAction 提前結束伸縮活動的等待狀態。

預設值：600。

生命週期掛鉤暫停伸縮活動時推送給NotificationArn（通知對象）的通知資訊，便於管理和標記不同類別的通知資訊。必須同時指定NotificationArn。參數長度不能超過 4096 個字元。

如果NotificationArn指定為 OOS 範本，包括公共範本或者自訂範本，則NotificationMetadata必須指定為 JSON 字串，且與 OOS 範本的參數相符。

例如，{"dbInstanceId": "dds-bp17661e0135****", "modifyMode": "Append"}，dbInstanceId和modifyMode為 OOS 範本中已定義的參數。OOS 範本的部分參數有預設值，NotificationMetadata必須指定無預設值的參數，指定有預設值的參數時會覆蓋原預設值，但以下參數請保持預設值，用於在伸縮活動執行時取得相關資訊：

• regionId：伸縮活動執行的地域，預設為${regionId}。

• instanceIds：伸縮活動關聯的執行個體列表，預設為${instanceIds}。

• lifecycleHookId：生命週期掛鉤 ID，預設為${lifecycleHookId}。

• lifecycleActionToken：伸縮活動的等待狀態標識符，用於提前結束當前的掛起活動，預設為${lifecycleActionToken}。

• scalingGroupId：伸縮活動所屬的伸縮組 ID，預設為${scalingGroupId}。

• lifecycleActionResult：生命週期掛鉤等待狀態結束後的下一步動作，用於在 OOS 範本執行失敗時提前結束當前的掛起活動，當DefaultResult為ROLLBACK時，參數值預設為ROLLBACK，其餘情況預設為ABANDON。

• 您可以在 OOS 控制台取得對應範本的參數的詳細資訊。

生命週期掛鉤通知對象標識符，不設定本參數表示不傳送通知，設定本參數時支援以下通知方式：

• MNS 佇列，參數取值格式：acs:mns:{region-id}:{account-id}:queue/{queuename}。

• MNS 主題，參數取值格式：acs:mns:{region-id}:{account-id}:topic/{topicname}。

• OOS 範本，參數取值格式：acs:oos:{region-id}:{account-id}:template/{templatename}。

• 事件匯流排，參數取值格式：acs:eventbridge:{region-id}:{account-id}:eventbus/default。

參數格式中的變數含義如下：

• region-id：伸縮組所在的地域的 ID。

• account-id：阿里雲帳號 ID，不支援 RAM 使用者的帳號 ID。

• queuename：MNS 佇列的名稱。

• topicname：MNS 主題的名稱。

• templatename：OOS 範本的名稱。