Auto Scaling:CreateLifecycleHook

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

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

デフォルト値: LifecycleHookId の値。

ライフサイクルフックが適用されるスケーリングアクティビティのタイプ。有効な値:

• SCALE_OUT: スケーリンググループのスケールアウトアクティビティ。

• SCALE_IN: スケーリンググループのスケールダウンアクティビティ。

待機状態の終了後に実行する操作。有効な値:

• CONTINUE: スケールアウトまたはスケールダウンアクティビティへの応答を続行します。

• ABANDON: スケールアウトアクティビティ中に作成された ECS インスタンスをリリースするか、スケールダウンアクティビティ中にスケーリンググループから ECS インスタンスを削除します。

• ROLLBACK: スケールダウンアクティビティの場合、システムは ECS インスタンスのリリースを拒否し、ロールバックを実行します。スケールアウトアクティビティの場合、システムは作成された ECS インスタンスをリリースし、ABANDON と同じ効果になります。

スケールダウンアクティビティ (SCALE_IN) がスケーリンググループ内の複数のライフサイクルフックをトリガーした場合、1 つのライフサイクルフックの DefaultResult が ABANDON または ROLLBACK に設定されており、そのフックの待機状態が終了すると、他のライフサイクルフックの待機状態も早期に終了します。それ以外の場合、実行する操作は待機状態が最後に終了するライフサイクルフックによって決定されます。

デフォルト値: CONTINUE。

ライフサイクルフックがスケーリンググループアクティビティに設定する待機期間。待機状態がタイムアウトすると、次の操作が実行されます。有効な値: 30～21600。単位: 秒。

ライフサイクルフックの作成後、 RecordLifecycleActionHeartbeat を呼び出して ECS インスタンスの待機期間を延長するか、 CompleteLifecycleAction を呼び出してスケーリングアクティビティの待機状態を早期に終了できます。

デフォルト値: 600。

ライフサイクルフックがスケーリングアクティビティを一時停止したときに NotificationArn (通知の受信者) にプッシュされる通知情報。このパラメーターは、異なるカテゴリの通知情報を管理およびタグ付けするのに役立ちます。NotificationArn も指定する必要があります。値は最大 4,096 文字です。

NotificationArn がパブリックテンプレートまたはカスタムテンプレートを含む OOS テンプレートに設定されている場合、NotificationMetadata は OOS テンプレートのパラメーターに一致する JSON フォーマットの文字列に設定する必要があります。

例: {"dbInstanceId": "dds-bp17661e0135****", "modifyMode": "Append"}。ここで dbInstanceId と modifyMode は OOS テンプレートで定義されたパラメーターです。OOS テンプレートの一部のパラメーターにはデフォルト値があります。NotificationMetadata ではデフォルト値のないパラメーターを指定する必要があります。デフォルト値のあるパラメーターを指定した場合、指定した値が元のデフォルト値を上書きします。ただし、スケーリングアクティビティ中に関連情報を取得するために使用される以下のパラメーターについては、デフォルト値を維持してください:

• regionId: スケーリングアクティビティが実行されるリージョン。デフォルト値: ${regionId}。

• instanceIds: スケーリングアクティビティに関連付けられたインスタンスのリスト。デフォルト値: ${instanceIds}。

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

• lifecycleActionToken: スケーリングアクティビティの待機状態の識別子。現在の一時停止されたアクティビティを早期に終了するために使用されます。デフォルト値: ${lifecycleActionToken}。

• scalingGroupId: スケーリングアクティビティが属するスケーリンググループの ID。デフォルト値: ${scalingGroupId}。

• lifecycleActionResult: ライフサイクルフックの待機状態終了後に実行する操作。OOS テンプレートが失敗した場合に現在の一時停止されたアクティビティを早期に終了するために使用されます。DefaultResult が ROLLBACK に設定されている場合、デフォルト値は ROLLBACK です。それ以外の場合、デフォルト値は ABANDON です。

• 対応するテンプレートのパラメーターの詳細情報は、OOS コンソールで取得できます。

ライフサイクルフックの通知の受信者の Alibaba Cloud リソースネーム (ARN)。このパラメーターが設定されていない場合、通知は送信されません。このパラメーターを設定する場合、以下の通知方法がサポートされています:

• MNS キュー。値のフォーマットは acs:mns:{region-id}:{account-id}:queue/{queuename} です。

• MNS トピック。値のフォーマットは acs:mns:{region-id}:{account-id}:topic/{topicname} です。

• OOS テンプレート。値のフォーマットは acs:oos:{region-id}:{account-id}:template/{templatename} です。

• EventBridge。値のフォーマットは acs:eventbridge:{region-id}:{account-id}:eventbus/default です。

フォーマット内の変数の意味は以下のとおりです:

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

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

• queuename: MNS キューの名前。

• topicname: MNS トピックの名前。

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