tencent cloud

1. API Description

Domain name for API request: as.tencentcloudapi.com.

This API is used to create a lifecycle hook.

• You can configure notifications or automation commands (TAT) for the lifecycle hook.

If you configured a notification, Auto Scaling will notify the TDMQ queue of the following information:

{
    "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": ""
}

A maximum of 20 requests can be initiated per second for this API.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

3. Output Parameters

4. Example

Example1 Creating a Lifecycle Hook

This example shows you how to create a lifecycle hook that takes effect in the scenario of instance creation, where DefaultResult is set to ABANDON and HeartbeatTimeout is set to 360 seconds.

Input Example

POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLifecycleHook
<Common request parameters>

{
    "AutoScalingGroupId": "asg-8fbozqja",
    "DefaultResult": "ABANDON",
    "LifecycleHookName": "one-hook",
    "LifecycleTransition": "INSTANCE_LAUNCHING",
    "HeartbeatTimeout": "360"
}

Output Example

{
    "Response": {
        "LifecycleHookId": "ash-heyubibl",
        "RequestId": "5e414011-3359-45bd-8ba4-5b503d3fd3f6"
    }
}

Example2 Creating a Lifecycle Hook with the Default Value

This example shows you how to create a lifecycle hook that takes effect in the scenario of instance creation, where DefaultResult takes the default value CONTINUE and HeartbeatTimeout takes the default value 300 seconds.

Input Example

POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLifecycleHook
<Common request parameters>

{
    "AutoScalingGroupId": "asg-8fbozqja",
    "LifecycleHookName": "one-hook-default",
    "LifecycleTransition": "INSTANCE_LAUNCHING"
}

Output Example

{
    "Response": {
        "LifecycleHookId": "ash-8azjzxj9",
        "RequestId": "4fa9fd2e-5b6c-49fe-9ba7-ed2ee62d8271"
    }
}

Example3 Creating a Lifecycle Hook to Notify the TDMQ Topic Model

This example shows you how to create a lifecycle hook that takes effect in the scenario of instance termination, where DefaultResult is set to ABANDON and HeartbeatTimeout is set to 120 seconds, to notify the TDMQ topic model named one-topic.

Input Example

POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLifecycleHook
<Common request parameters>

{
    "HeartbeatTimeout": "120",
    "AutoScalingGroupId": "asg-8fbozqja",
    "LifecycleHookName": "terminate-topic",
    "NotificationMetadata": "topic",
    "NotificationTarget": {
        "TargetType": "TDMQ_TOPIC",
        "TopicName": "one-topic"
    },
    "DefaultResult": "ABANDON",
    "LifecycleTransition": "INSTANCE_TERMINATING"
}

Output Example

{
    "Response": {
        "LifecycleHookId": "ash-oq76wsrx",
        "RequestId": "cdb7670b-0412-444f-9d2f-0da9cd07c410"
    }
}

Example4 Creating a Lifecycle Hook to Notify the TDMQ Model

This example shows you how to create a lifecycle hook that takes effect in the scenario of instance creation, where DefaultResult is set to CONTINUE and HeartbeatTimeout is set to 120 seconds, to notify the TDMQ model named one-queue.

Input Example

POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLifecycleHook
<Common request parameters>

{
    "HeartbeatTimeout": "120",
    "AutoScalingGroupId": "asg-8fbozqja",
    "LifecycleHookName": "launch-queue",
    "NotificationMetadata": "queue",
    "NotificationTarget": {
        "TargetType": "TDMQ_QUEUE",
        "QueueName": "one-queue"
    },
    "DefaultResult": "CONTINUE",
    "LifecycleTransition": "INSTANCE_LAUNCHING"
}

Output Example

{
    "Response": {
        "LifecycleHookId": "ash-fbjiexz7",
        "RequestId": "d3cf27b7-3090-4317-9107-d2eac986a446"
    }
}

Example5 Creating a Lifecycle Hook to Execute TAT Commands

This example shows you how to create a lifecycle hook that takes effect upon instance creation, where DefaultResult takes the default value CONTINUE and HeartbeatTimeout takes the default value 300 seconds.

Input Example

POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLifecycleHook
<Common request parameters>

{
    "HeartbeatTimeout": "300",
    "AutoScalingGroupId": "asg-mp5ydedh",
    "LifecycleCommand": {
        "CommandId": "cmd-id9u919l",
        "Parameters": "{\"var1\":\"ck\"}"
    },
    "LifecycleHookName": "demo2",
    "DefaultResult": "CONTINUE",
    "LifecycleTransition": "INSTANCE_LAUNCHING"
}

Output Example

{
    "Response": {
        "LifecycleHookId": "ash-kjurq12y",
        "RequestId": "08f7bea5-3e0a-4280-9970-5d959a922b0b"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

• Tencent Cloud SDK 3.0 for Python
• Tencent Cloud SDK 3.0 for Java
• Tencent Cloud SDK 3.0 for PHP
• Tencent Cloud SDK 3.0 for Go
• Tencent Cloud SDK 3.0 for Node.js
• Tencent Cloud SDK 3.0 for .NET
• Tencent Cloud SDK 3.0 for C++

Command Line Interface

• Tencent Cloud CLI 3.0

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.