# 伸缩实例生命周期回调 - AttachCallbackInstanceLifeCycleHook #### 功能介绍 通过生命周期操作令牌或者通过实例ID和生命周期挂钩名称对伸缩实例指定的挂钩进行回调操作。 - 如果在超时时间结束前已完成自定义操作，选择终止或继续完成生命周期操作。 - 如果需要更多时间完成自定义操作，选择延长超时时间，实例保持等待状态的时间将增加1小时。 - 只有实例的生命周期挂钩状态为HANGING时才可以进行回调操作。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AS/doc?api=AttachCallbackInstanceLifeCycleHook)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-as/as_07_0200.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | as:scalingGroup:callbackInstanceHook | write | scalingGroup\* | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | as:instanceHooks:action | - | #### URI PUT /autoscaling-api/v1/{project_id}/scaling_instance_hook/{scaling_group_id}/callback 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID | | scaling_group_id | 是 | String | 伸缩组ID | #### 请求参数 表2请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | lifecycle_action_key | 否 | String | 生命周期操作令牌，通过[查询伸缩实例挂起信息](https://support.huaweicloud.com/api-as/as_06_0906.html)接口获取。 指定生命周期回调对象，当不传入instance_id字段时，该字段为必选。当该字段与instance_id字段都传入时，优先使用该字段进行回调。 | | instance_id | 否 | String | 实例ID。 指定生命周期回调对象，当不传入lifecycle_action_key字段时，该字段为必选。 | | lifecycle_hook_name | 否 | String | 生命周期挂钩名称。 指定生命周期回调对象，当不传入lifecycle_action_key字段时，该字段为必选 | | lifecycle_action_result | 是 | String | 生命周期回调操作。 - ABANDON：终止。 - CONTINUE：继续。 - EXTEND：延长超时时间，每次延长1小时。 | #### 请求示例 在ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组内通过生命周期操作令牌23880867-6288-4470-98a8-f8bda096b6c4进行ABANDON的回调操作。 ``` PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_instance_hook/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/callback { "lifecycle_action_result": "ABANDON", "lifecycle_action_key":"23880867-6288-4470-98a8-f8bda096b6c4" } ``` #### 响应参数 无 #### 响应示例 无 #### 返回值 - 正常 204 - 异常 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 服务器未能处理请求。 | | 401 Unauthorized | 被请求的页面需要用户名和密码。 | | 403 Forbidden | 对被请求的页面访问禁止。 | | 404 Not Found | 服务器无法找到被请求的页面。 | | 405 Method Not Allowed | 请求中指定的方法不被允许。 | | 406 Not Acceptable | 服务器生成的响应无法被客户端所接受。 | | 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 | | 408 Request Timeout | 请求超出了服务器的等待时间。 | | 409 Conflict | 由于冲突，请求无法被完成。 | | 500 Internal Server Error | 请求未完成。服务异常。 | | 501 Not Implemented | 请求未完成。服务器不支持所请求的功能。 | | 502 Bad Gateway | 请求未完成。服务器从上游服务器收到一个无效的响应。 | | 503 Service Unavailable | 请求未完成。系统暂时异常。 | | 504 Gateway Timeout | 网关超时。 | #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-as/as_07_0102.html)。