租户端 计算 弹性伸缩（AS） 生命周期钩子相关接口 创建生命周期挂钩

创建生命周期挂钩

最近更新时间: 2024-10-18 10:38:34

1. 接口描述

接口请求域名： as.api3.fincloud.tencent.cn。

本接口（CreateLifecycleHook）用于创建生命周期挂钩。

  • 您可以为生命周期挂钩配置消息通知，弹性伸缩会通知您的CMQ消息队列，通知内容形如：
{
    "Service": "Tencent Cloud Auto Scaling",
    "Time": "2019-03-14T10:15:11Z",
    "AppId": "1251783334",
    "ActivityId": "asa-fznnvrja",
    "AutoScalingGroupId": "asg-rrrrtttt",
    "LifecycleHookId": "ash-xxxxyyyy",
    "LifecycleHookName": "my-hook",
    "LifecycleActionToken": "3080e1c9-0efe-4dd7-ad3b-90cd6618298f",
    "InstanceId": "ins-aaaabbbb",
    "LifecycleTransition": "INSTANCE_LAUNCHING",
    "NotificationMetadata": ""
}

默认接口请求频率限制：20次/秒。

接口更新时间：2019-10-31 18:27:50。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：CreateLifecycleHook
Version 是 否 String 公共参数，本接口取值：2018-04-19
Region 是 否 String 公共参数，详见产品支持的地域列表(TODO)
AutoScalingGroupId 是 否 String 伸缩组ID
DefaultResult 否 否 String 定义伸缩组在生命周期挂钩超时的情况下应采取的操作，取值范围是“CONTINUE”或“ABANDON”，默认值为“CONTINUE”
HeartbeatTimeout 否 否 Int64 生命周期挂钩超时之前可以经过的最长时间（以秒为单位），范围从30到3600秒，默认值为300秒
LifecycleHookName 是 否 String 生命周期挂钩名称。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超128个字节。
LifecycleTransition 是 否 String 进行生命周期挂钩的场景，取值范围包括“INSTANCE_LAUNCHING”和“INSTANCE_TERMINATING”
NotificationMetadata 否 否 String 弹性伸缩向通知目标发送的附加信息，默认值为''。最大长度不能超过1024个字节。
NotificationTarget 否 否 NotificationTarget 通知目标

3. 输出参数

参数名称 类型 描述
LifecycleHookId String 生命周期挂钩ID
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InvalidParameterValue.LifecycleHookNameDuplicated
InvalidParameter.Conflict
InvalidParameter
MissingParameter
InvalidParameterValue.Filter
InternalError
InvalidParameterValue
InternalError.CallTDMQError
ResourceNotFound.ResourceNotFoundTDMQPulsarTopicNotFound