如果伸縮組內生命週期掛鈎觸發後被掛起的ECS執行個體的等待時間不能滿足您的自訂動作，在ECS執行個體被掛起狀態下，調用RecordLifecycleActionHeartbeat，通過參數：生命週期掛鈎的ID、伸縮活動的等待狀態標識符、需設定的等待時間，延長掛起時間。
介面說明
只能在ECS執行個體被掛起的狀態下調用該介面來延長等待時間。
ECS執行個體的等待時間不能超過6小時，每次等待狀態最多能被延時20次。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
|
名稱 |
類型 |
是否必選 |
樣本值 |
描述 |
| Action | String | 是 | RecordLifecycleActionHeartbeat | 系統規定參數。取值：RecordLifecycleActionHeartbeat。 |
| lifecycleHookId | String | 是 | ash-bp1fxuqyi98w0aib**** | 生命週期掛鈎的ID。 |
| lifecycleActionToken | String | 是 | F324B880-900E-4968-85DD-81691113**** | 伸縮活動的等待狀態標識符，您可以在執行個體被掛起的狀態下，從生命週期掛鈎指定的MNS隊列中，接收訊息對應的詳情頁中擷取。 也可以調用DescribeLifecycleActions擷取。 還可以從生命週期掛鈎指定的MNS主題中擷取該值。 |
| heartbeatTimeout | Integer | 否 | 600 | 生命週期掛鈎為伸縮組活動設定的等待時間，等待狀態逾時後會執行預設執行策略。取值範圍：30~21600，單位：秒。 建立了生命週期掛鈎後，您可以調用本介面延長ECS執行個體的等待時間，也可以調用CompleteLifecycleAction提前結束伸縮活動的等待狀態。 預設值：600。 |
| RegionId | String | 否 | cn-hangzhou | 伸縮組所屬的地區ID。 |
返回資料
名稱 |
類型 |
樣本值 |
描述 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 請求ID。 |
樣本
請求樣本
http(s)://ess.aliyuncs.com/?Action=RecordLifecycleActionHeartbeat
&lifecycleHookId=ash-bp1fxuqyi98w0aib****
&lifecycleActionToken=F324B880-900E-4968-85DD-81691113****
&heartbeatTimeout=600
&RegionId=cn-hangzhou
&公用請求參數正常返回樣本
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecordLifecycleActionHeartbeatResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</RecordLifecycleActionHeartbeatResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpCode |
錯誤碼 |
錯誤資訊 |
描述 |
400 |
InvalidParamter |
The specified value of parameter is not valid. |
指定的參數值不合法。 |
400 |
LifecycleHookIdAndLifecycleActionToken.Invalid |
The specified lifecycleActionToken and LifecycleHookId you provided does not match any in process lifecycle action. |
根據指定的lifecycleActionToken無法匹配LifecycleHookId。 |
400 |
LifecycleAction.TimeExceeded |
The specified parameter heartbeatTime exceed lifecycleAction max suspend time. |
等待時間最長不能超過6小時。 |
400 |
LifecycleAction.RecordTimesExceeded |
The specified lifecycleAction exceed lifecycleAction max record times. |
每次等待狀態最多能被延時20次。 |