RecordLifecycleActionHeartbeat
如果伸縮組內(nèi)生命周期掛鉤觸發(fā)后被掛起的ECS實例的等待時間不能滿足您的自定義操作，在ECS實例被掛起狀態(tài)下，調(diào)用RecordLifecycleActionHeartbeat，通過參數(shù)：生命周期掛鉤的ID、伸縮活動的等待狀態(tài)標(biāo)識符、需設(shè)置的等待時間，延長掛起時間。
接口說明
只能在ECS實例被掛起的狀態(tài)下調(diào)用該接口來延長等待時間。
ECS實例的等待時間不能超過6小時，每次等待狀態(tài)最多能被延時20次。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | RecordLifecycleActionHeartbeat | 系統(tǒng)規(guī)定參數(shù)。取值：RecordLifecycleActionHeartbeat。 |
| lifecycleHookId | String | 是 | ash-bp1fxuqyi98w0aib**** | 生命周期掛鉤的ID。 |
| lifecycleActionToken | String | 是 | F324B880-900E-4968-85DD-81691113**** | 伸縮活動的等待狀態(tài)標(biāo)識符，您可以在實例被掛起的狀態(tài)下，從生命周期掛鉤指定的MNS隊列中，接收消息對應(yīng)的詳情頁中獲取。 也可以調(diào)用DescribeLifecycleActions獲取。 還可以從生命周期掛鉤指定的MNS主題中獲取該值。 |
| heartbeatTimeout | Integer | 否 | 600 | 生命周期掛鉤為伸縮組活動設(shè)置的等待時間，等待狀態(tài)超時后會執(zhí)行默認(rèn)執(zhí)行策略。取值范圍：30~21600，單位：秒。 創(chuàng)建了生命周期掛鉤后，您可以調(diào)用本接口延長ECS實例的等待時間，也可以調(diào)用CompleteLifecycleAction提前結(jié)束伸縮活動的等待狀態(tài)。 默認(rèn)值：600。 |
| RegionId | String | 否 | cn-hangzhou | 伸縮組所屬的地域ID。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
| 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
&公共請求參數(shù)正常返回示例
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. |
指定的參數(shù)值不合法。 |
400 |
LifecycleHookIdAndLifecycleActionToken.Invalid |
The specified lifecycleActionToken and LifecycleHookId you provided does not match any in process lifecycle action. |
根據(jù)指定的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. |
每次等待狀態(tài)最多能被延時20次。 |