Auto Scaling:CreateLifecycleHook

スケーリンググループの ID。

ライフサイクルフックの名前。各ライフサイクルフック名は、スケーリンググループ内で一意である必要があります。名前は 2 ～ 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。英字または数字で始まる必要があります。

このパラメータを指定しない場合、LifecycleHookId パラメータの値を使用します。

ライフサイクルフックが適用されるスケーリングアクティビティのタイプ。有効な値は次のとおりです：

• SCALE_OUT

• SCALE_IN

ライフサイクルフックがタイムアウトした後に Auto Scaling が実行するアクション。有効な値は次のとおりです：

• CONTINUE： Auto Scaling は、スケールインまたはスケールアウトのリクエストへの対応を続行します。

• ABANDON： Auto Scaling は、スケールアウトアクティビティ中に作成された Elastic Compute Service (ECS) インスタンスをリリースするか、スケールインアクティビティ中にスケーリンググループから ECS インスタンスを除去します。

スケーリンググループ内の複数のライフサイクルフックがスケールインアクティビティ中にトリガーされ、いずれかのライフサイクルフックの DefaultResult パラメータを ABANDON に設定した場合、Auto Scaling は、DefaultResult が ABANDON に設定されているライフサイクルフックがタイムアウトした直後にアクションを実行します。その結果、他のライフサイクルフックは予定より早くタイムアウトします。それ以外の場合、Auto Scaling は、すべてのライフサイクルフックがタイムアウトした後にのみアクションを実行します。

デフォルト値： CONTINUE。

ライフサイクルフックがタイムアウトするまでの期間。ライフサイクルフックがタイムアウトすると、Auto Scaling はデフォルトのアクションを実行します。有効な値： 30 ～ 21600。単位： 秒。

ライフサイクルフックを作成した後、RecordLifecycleActionHeartbeat API を呼び出してライフサイクルフックのタイムアウト期間を延長できます。また、CompleteLifecycleAction API を呼び出して、ライフサイクルフックのタイムアウト期間を予定より早く終了することもできます。

デフォルト値： 600。

ライフサイクルフックが有効になったときに送信される通知メタデータ。これにより、通知を効率的に管理および分類できます。このパラメータを指定する場合は、NotificationArn パラメータを指定する必要があります。値は 4,096 文字以内である必要があります。

NotificationArn パラメータを使用してパブリックまたはカスタムの OOS テンプレートを指定する場合、NotificationMetadata パラメータの値は、OOS テンプレートパラメータを含む JSON 文字列である必要があります。たとえば、OOS テンプレートに次のパラメータが含まれているとします： {"dbInstanceId": "dds-bp17661e0135****", "modifyMode": "Append"}、dbInstanceId、および modifyMode。OOS テンプレートで定義されている一部のパラメータにはデフォルト値があります。NotificationMetadata パラメータを指定する場合は、デフォルト値がないパラメータを指定してください。デフォルト値があるパラメータを指定すると、デフォルト値が上書きされます。ただし、進行中のスケーリングアクティビティに関する情報を取得するには、次のパラメータのデフォルト値を保持する必要があります。

• regionId： 進行中のスケーリングアクティビティのリージョン ID。デフォルト値： ${regionId}。

• instanceIds： スケーリングアクティビティでスケールイン対象の ECS インスタンスの ID。デフォルト値： ${instanceIds}。

• lifecycleHookId： ライフサイクルフックの ID。デフォルト値： ${lifecycleHookId}。

• lifecycleActionToken： ライフサイクルアクションのトークン。このトークンを使用して、ライフサイクルフックのタイムアウト期間を予定より早く終了できます。デフォルト値： ${lifecycleActionToken}

• scalingGroupId： スケーリングアクティビティが実行されるスケーリンググループの ID。デフォルト値： ${scalingGroupId}。

通知の受信者の Alibaba Cloud Resource Name (ARN)。このパラメータを指定しない場合、ライフサイクルフックが有効になったときに通知は送信されません。このパラメータを指定する場合、値は、次のいずれかの形式で指定する必要があります：

• Simple Message Queue (SMQ、旧 MNS) を通知の受信者として指定する場合は、acs:mns:{region-id}:{account-id}:queue/{queuename} 形式で値を指定します。

• SMQ トピックを通知の受信者として指定する場合は、acs:mns:{region-id}:{account-id}:topic/{topicname} 形式で値を指定します。

• CloudOps Orchestration Service (OOS) テンプレートを通知の受信者として指定する場合は、acs:oos:{region-id}:{account-id}:template/{templatename} 形式で値を指定します。

• イベントバスを通知の受信者として指定する場合は、acs:eventbridge:{region-id}:{account-id}:eventbus/default 形式で値を指定します。

上記の値形式における各変数の意味は、次のとおりです：

• region-id： スケーリンググループのリージョン ID。

• account-id： Alibaba Cloud アカウントの ID。Resource Access Management (RAM) ユーザーの ID はサポートされていません。

• queuename： SMQ キューの名前。

• topicname： SMQ トピックの名前。

• templatename： OOS テンプレートの名前。