如果當前伸縮組的生命周期掛鉤不能滿足業務需求,您無需做刪除操作,調用ModifyLifecycleHook,通過待修改生命周期掛鉤的ID或名稱,伸縮組的ID等參數,修改一個生命周期掛鉤的信息,包括生命周期掛鉤適用的伸縮活動類型,生命周期掛鉤為伸縮組活動設置的等待時間,等待狀態結束后的下一步動作等信息。
接口說明
您可以通過以下兩種方式指定待修改的生命周期掛鉤:
-
只指定生命周期掛鉤 ID(LifecycleHookId),此時將忽略伸縮組 ID(ScalingGroupId)和生命周期掛鉤名稱(LifecycleHookName)參數。
-
同時指定伸縮組 ID(ScalingGroupId)與生命周期掛鉤名稱(LifecycleHookName),因為在一個伸縮組內同一個生命周期掛鉤名稱是唯一的。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ess:ModifyLifecycleHook | update | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
LifecycleHookId | string | 否 | 待修改生命周期掛鉤的 ID,用于指定生命周期掛鉤。 | ash-bp1fxuqyi98w0aib**** |
ScalingGroupId | string | 否 | 伸縮組的 ID,用于指定生命周期掛鉤。 | asg-bp18p2yfxow2dloq**** |
LifecycleHookName | string | 否 | 待修改生命周期掛鉤的名稱,用于指定生命周期掛鉤。 | test_SCAL**** |
DefaultResult | string | 否 | 等待狀態結束后的下一步動作,取值范圍:
當伸縮組發生彈性收縮活動(SCALE_IN)并觸發多個生命周期掛鉤時,如果一個生命周期掛鉤的 DefaultResult 取值為 ABANDON 或 ROLLBACK,且該掛鉤等待狀態結束時,會提前將其他生命周期掛鉤對應的等待狀態提前結束。其他情況下,下一步動作均以最后一個結束等待狀態的下一步動作為準。 | CONTINUE |
HeartbeatTimeout | integer | 否 | 生命周期掛鉤為伸縮組活動設置的等待時間,等待狀態超時后會執行下一步動作。取值范圍:30~21600,單位:秒。 您可以調用 RecordLifecycleActionHeartbeat 延長 ECS 實例的等待時間,也可以調用 CompleteLifecycleAction 提前結束伸縮活動的等待狀態。 | 600 |
LifecycleTransition | string | 否 | 生命周期掛鉤適用的伸縮活動類型,取值范圍:
| SCALE_IN |
NotificationMetadata | string | 否 | 伸縮活動的等待狀態的固定字符串信息。參數長度不能超過 4096 個字符。 彈性伸縮每次推送消息到通知對象時,會同時發送您預先指定的 NotificationMetadata 參數值,便于管理和標記不同類別的通知信息。當您同時指定了 NotificationArn 參數時,NotificationMetadata 參數方可生效。 | Test |
NotificationArn | string | 否 | 生命周期掛鉤通知對象標識符,設置本參數時支持以下通知方式:
參數格式中的變量含義如下:
| acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo**** |
RegionId | string | 否 | 伸縮組所屬的地域 ID。 | cn-beijing |
LifecycleHookStatus | string | 否 | 修改當前生命周期掛鉤的狀態,取值范圍:
如果不設置該參數,則當前生命周期掛鉤狀態保持為原有狀態。 說明
生命周期掛鉤創建成功后,系統默認為啟動狀態。
| Active |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2022-10-13 | OpenAPI 入參發生變更 | 查看變更詳情 |