ModifyLifecycleHook
如果當(dāng)前伸縮組的生命周期掛鉤不能滿足業(yè)務(wù)需求,您無(wú)需做刪除操作,調(diào)用ModifyLifecycleHook,通過(guò)待修改生命周期掛鉤的ID或名稱,伸縮組的ID等參數(shù),修改一個(gè)生命周期掛鉤的信息,包括生命周期掛鉤適用的伸縮活動(dòng)類型,生命周期掛鉤為伸縮組活動(dòng)設(shè)置的等待時(shí)間,等待狀態(tài)結(jié)束后的下一步動(dòng)作等信息。
接口說(shuō)明
您可以通過(guò)以下兩種方式指定待修改的生命周期掛鉤:
- 只指定生命周期掛鉤ID(
LifecycleHookId
),此時(shí)將忽略伸縮組ID(ScalingGroupId
)和生命周期掛鉤名稱(LifecycleHookName
)參數(shù)。 - 同時(shí)指定伸縮組ID(
ScalingGroupId
)與生命周期掛鉤名稱(LifecycleHookName
),因?yàn)樵谝粋€(gè)伸縮組內(nèi)同一個(gè)生命周期掛鉤名稱是唯一的。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ModifyLifecycleHook | 系統(tǒng)規(guī)定參數(shù)。取值:ModifyLifecycleHook。 |
LifecycleHookId | String | 否 | ash-bp1fxuqyi98w0aib**** | 待修改生命周期掛鉤的ID,用于指定生命周期掛鉤。 |
ScalingGroupId | String | 否 | asg-bp18p2yfxow2dloq**** | 伸縮組的ID,用于指定生命周期掛鉤。 |
LifecycleHookName | String | 否 | test_SCAL**** | 待修改生命周期掛鉤的名稱,用于指定生命周期掛鉤。 |
DefaultResult | String | 否 | CONTINUE | 等待狀態(tài)結(jié)束后的下一步動(dòng)作。取值范圍:
當(dāng)伸縮組發(fā)生彈性收縮活動(dòng)(SCALE_IN)并觸發(fā)多個(gè)生命周期掛鉤時(shí),如果一個(gè)生命周期掛鉤的 |
HeartbeatTimeout | Integer | 否 | 600 | 生命周期掛鉤為伸縮組活動(dòng)設(shè)置的等待時(shí)間,等待狀態(tài)超時(shí)后會(huì)執(zhí)行下一步動(dòng)作。取值范圍:30~21600,單位:秒。 您可以調(diào)用RecordLifecycleActionHeartbeat延長(zhǎng)ECS實(shí)例的等待時(shí)間,也可以調(diào)用CompleteLifecycleAction提前結(jié)束伸縮活動(dòng)的等待狀態(tài)。 |
LifecycleTransition | String | 否 | SCALE_IN | 生命周期掛鉤適用的伸縮活動(dòng)類型,取值范圍:
|
NotificationMetadata | String | 否 | Test | 伸縮活動(dòng)的等待狀態(tài)的固定字符串信息。參數(shù)長(zhǎng)度不能超過(guò)4096個(gè)字符。 彈性伸縮每次推送消息到通知對(duì)象時(shí),會(huì)同時(shí)發(fā)送您預(yù)先指定的 |
NotificationArn | String | 否 | acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo**** | 生命周期掛鉤通知對(duì)象標(biāo)識(shí)符。設(shè)置本參數(shù)時(shí)支持以下通知方式:
參數(shù)格式中的變量含義如下:
|
RegionId | String | 否 | cn-beijing | 伸縮組所屬的地域ID。 |
LifecycleHookStatus | String | 否 | Active | 修改當(dāng)前生命周期掛鉤的狀態(tài)。取值范圍:
如果不設(shè)置該參數(shù),則當(dāng)前生命周期掛鉤狀態(tài)保持為原有狀態(tài)。 說(shuō)明 生命周期掛鉤創(chuàng)建成功后,系統(tǒng)默認(rèn)為啟動(dòng)狀態(tài)。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請(qǐng)求ID。 |
示例
請(qǐng)求示例
http(s)://ess.aliyuncs.com/?Action=ModifyLifecycleHook
&LifecycleHookId=ash-bp1fxuqyi98w0aib****
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&LifecycleHookName=test_SCALE_IN
&DefaultResult=CONTINUE
&HeartbeatTimeout=600
&LifecycleTransition=SCALE_IN
&NotificationMetadata=Test
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&RegionId=cn-beijing
&LifecycleHookStatus=Active
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyLifecycleHookResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyLifecycleHookResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
400 |
InvalidParamter |
The specified value of parameter is not valid. |
參數(shù)值不合法。 |
400 |
InvalidLifecycleHookId.NotExist |
The specified lifecycleHookId not exist. |
指定的LifecycleHookId不存在。 |
400 |
InvalidLifecycleHookName.NotExist |
The specified lifecycleHookName you provided not exist. |
指定的LifecycleHookName不存在。 |
400 |
InvalidNotificationArn |
The specified parameter NotificationArn is invalid. |
指定的NotificationArn不存在。 |
400 |
UnsupportedNotificationType.CurrentRegion |
The NotificationType is not supported in the special region which scalingGroup belongs to. |
當(dāng)前地域不支持該通知方式。 |
400 |
LifecycleHook |
The specified queue does not exist. |
指定的MNS隊(duì)列不存在。 |
400 |
TopicNotExist |
The specified topic does not exist. |
指定的MNS主題不存在。 |