Auto Scaling:CreateScalingRule

スケーリングルールが属するスケーリンググループの ID です。

スケーリングルールの名前です。名前は 2 ～ 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を使用できます。名前は英字または数字で始まる必要があります。

スケーリングルール名は、同一リージョン内の同一アカウントにおいて一意である必要があります。

このパラメーターを空のままにすると、スケーリングルール ID が使用されます。

スケーリングルールのクールダウン時間です。このパラメーターは、ScalingRuleType パラメーターを SimpleScalingRule に設定した場合にのみ有効です。有効な値：0 ～ 86400。単位：秒。

デフォルト値はありません。

AdjustmentType パラメーターを PercentChangeInCapacity に設定した場合にスケーリングされるインスタンスの最小数です。このパラメーターは、ScalingRuleType パラメーターを SimpleScalingRule または StepScalingRule に設定した場合にのみ有効です。

スケーリングルールのスケーリング方法です。このパラメーターは、ScalingRuleType パラメーターを SimpleScalingRule または StepScalingRule に設定した場合にのみ必須です。有効な値：

• QuantityChangeInCapacity：スケーリンググループに対し、指定された数の ECS インスタンスを追加または削除します。

• PercentChangeInCapacity：スケーリンググループに対し、指定された割合の ECS インスタンスを追加または削除します。

• TotalCapacity：スケーリンググループ内の ECS インスタンス数を指定された数に調整します。

スケーリングルールに基づいてスケーリングされるインスタンスの数です。このパラメーターは、ScalingRuleType パラメーターを SimpleScalingRule または StepScalingRule に設定した場合にのみ必須です。1 回のスケーリングアクティビティでスケーリングされる ECS インスタンスの数は 1,000 を超えることはできません。

• AdjustmentType が QuantityChangeInCapacity の場合の有効な値：-1000 ～ 1000。

• AdjustmentType が PercentChangeInCapacity の場合の有効な値：-100 ～ 10000。

• AdjustmentType が TotalCapacity の場合の有効な値：0 ～ 2000。

スケーリングルールのタイプです。有効な値：

• SimpleScalingRule：簡易スケーリングルールです。簡易スケーリングルールを実行すると、Auto Scaling は AdjustmentType と AdjustmentValue の値に基づいて、スケーリンググループ内の ECS インスタンスまたはエラスティックコンテナインスタンスの数を調整します。

• TargetTrackingScalingRule：ターゲット追跡スケーリングルールです。ターゲット追跡スケーリングルールを実行すると、Auto Scaling は事前定義済みメトリクス (MetricName) に基づいてスケーリングする ECS インスタンスまたはエラスティックコンテナインスタンスの数を動的に計算し、メトリクス値を期待値 (TargetValue) に近づけるように維持します。

• StepScalingRule：ステップスケーリングルールです。ステップスケーリングルールを実行すると、Auto Scaling は事前定義されたしきい値とメトリクス値に基づいて、インスタンスを段階的にスケーリングします。

• PredictiveScalingRule：予測スケーリングルールです。予測スケーリングルールを実行すると、Auto Scaling は機械学習を使用してスケーリンググループの過去の監視データを分析し、メトリクスの将来の値を予測します。さらに、Auto Scaling はスケーリンググループの境界値を調整するためのスケジュールされたタスクを自動的に作成します。

デフォルト値：SimpleScalingRule。

インスタンスのウォームアップ期間です。このパラメーターは、ScalingRuleType パラメーターを TargetTrackingScalingRule または PredictiveScalingRule に設定した場合にのみ有効です。Auto Scaling はウォームアップ状態の ECS インスタンスをスケーリンググループに追加しますが、ウォームアップ期間中は CloudMonitor に監視データを報告しません。

有効な値：0 ～ 86400。単位：秒。

デフォルト値：300。

監視対象の事前定義済みメトリクスです。ScalingRuleType を TargetTrackingScalingRule または PredictiveScalingRule に設定する場合は、このパラメーターを指定する必要があります。

ScalingRuleType が TargetTrackingScalingRule の場合の有効な値：

• CpuUtilizationAgent (推奨)：CPU 使用率。

• MemoryUtilization (推奨)：メモリ使用率。

• CpuUtilization：平均 CPU 使用率。

• IntranetTx：内部ネットワークの平均アウトバウンドトラフィック。

• IntranetRx：内部ネットワークの平均インバウンドトラフィック。

• VpcInternetTx：Virtual Private Cloud (VPC) からインターネットへのアウトバウンドトラフィック。

• VpcInternetRx：インターネットから VPC へのインバウンドトラフィック。

• LoadBalancerRealServerAverageQps：Application Load Balancer (ALB) サーバーグループあたりの 1 秒あたりのクエリ数 (QPS)。

ScalingRuleType が PredictiveScalingRule の場合の有効な値：

• CpuUtilization：平均 CPU 使用率。

• IntranetRx：内部ネットワークの平均インバウンドトラフィック。

• IntranetTx：内部ネットワークの平均アウトバウンドトラフィック。

詳細については、「システム監視タイプのイベントトリガータスク」をご参照ください。

目標値です。このパラメーターは、ScalingRuleType パラメーターを TargetTrackingScalingRule または PredictiveScalingRule に設定した場合にのみ必須です。値は 0 より大きく、小数点以下 3 桁まで指定できます。

スケールインを無効にするかどうかを指定します。このパラメーターは、ScalingRuleType を TargetTrackingScalingRule に設定した場合にのみ有効です。

デフォルト値：false。

スケールインアクティビティ用のイベントトリガータスクがアラートをトリガーするまでに、しきい値条件を連続で満たす必要がある回数です。ターゲット追跡スケーリングルールが作成されると、イベントトリガータスクが自動的に作成され、ターゲット追跡スケーリングルールに関連付けられます。

デフォルト値：15。

スケールアウトアクティビティ用のイベントトリガータスクがアラートをトリガーするまでに、しきい値条件を連続で満たす必要がある回数です。ターゲット追跡スケーリングルールが作成されると、イベントトリガータスクが自動的に作成され、ターゲット追跡スケーリングルールに関連付けられます。

デフォルト値：3。

予測スケーリングルールのモードです。有効な値：

• PredictAndScale：予測を生成し、予測タスクを作成します。

• PredictOnly：予測を生成しますが、予測タスクは作成しません。

デフォルト値：PredictAndScale。

予測タスクの最大値の動作です。有効な値：

• MaxOverridePredictiveValue：予測値が初期最大キャパシティより大きい場合、予測タスクの最大値として初期最大キャパシティを使用します。

• PredictiveValueOverrideMax：予測値が初期最大キャパシティより大きい場合、予測タスクの最大値として予測値を使用します。

• PredictiveValueOverrideMaxWithBuffer：PredictiveValueBuffer パラメーターで指定された割合で予測値を増加させます。この値が初期最大キャパシティより大きい場合、増加後の値を予測タスクの最大値として使用します。

デフォルト値：MaxOverridePredictiveValue。

PredictiveValueBehavior を PredictiveValueOverrideMaxWithBuffer に設定した場合に、予測値を増加させる割合です。この割合で増加させた予測値が初期最大キャパシティを超える場合、増加後の値が予測タスクの最大値として使用されます。有効な値：0 ～ 100。

デフォルト値：0。

予測タスクが実行される前のバッファ時間です。デフォルトでは、予測スケーリングルール用に自動的に作成されたすべての予測タスクは毎正時に実行されます。予測タスクが実行される前のリソース準備のためのバッファ時間を指定できます。有効な値：0 ～ 60。単位：分。

デフォルト値：0。

スケーリンググループに含めることができる ECS インスタンスの最大数です。InitialMaxSize を指定する場合は、PredictiveValueBehavior を指定する必要があります。

このパラメーターのデフォルト値は MaxSize の値です。

スケーリンググループのリージョン ID です。

メトリクスのタイプです。有効な値：

• system：CloudMonitor のシステムメトリクス。

• custom：CloudMonitor に報告されるカスタムメトリクス。

• hybrid：ハイブリッドクラウドモニタリングのメトリクス。

ハイブリッドクラウドモニタリング名前空間の ID です。

ハイブリッドクラウドモニタリング名前空間の管理方法については、「名前空間の管理」をご参照ください。