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 模板的名稱。