すべてのプロダクト
Search

このプロダクト

    Auto Scaling:CreateScalingRule

    ドキュメントセンター

    Auto Scaling:CreateScalingRule

    最終更新日:Sep 17, 2026

    スケーリングルールを作成します。

    操作説明

    操作の説明

    パラメーターに関する次の情報に注意してください。

    • AdjustmentType が TotalCapacity に設定されている場合、現在のスケーリンググループ内の ECS または ECI インスタンスの数が指定された値に調整されます。対応する AdjustmentValue は 0 以上である必要があります。

    • AdjustmentType が QuantityChangeInCapacity または PercentChangeInCapacity に設定されている場合、正の AdjustmentValue は ECS インスタンスが追加されることを示し、負の値は ECS インスタンスが削除されることを示します。

    • AdjustmentType が PercentChangeInCapacity に設定されている場合、Auto Scaling は次の数式を使用して、追加または削除する ECS または ECI インスタンスの数を計算します。スケーリンググループ内の現在のインスタンス数 (Total Capacity) × AdjustmentValue/100。結果は最も近い整数に丸められます。

    • スケーリングルールでクールダウン時間 (Cooldown) が指定されている場合、スケーリングルールによってトリガーされたスケーリングアクティビティの完了後、スケーリングルールで指定されたクールダウン時間が効果を発揮します。スケーリングルールでクールダウン時間が指定されていない場合、スケーリンググループに指定されたクールダウン時間 (DefaultCooldown) が効果を発揮します。

    • スケーリンググループで作成できるスケーリングルールの数には制限があります。詳細については、「使用制限」を参照してください。

    • 返されるスケーリングルールの一意な識別子 (ScalingRuleAri) は、次の操作で使用できます。

      • ExecuteScalingRule 操作を呼び出してスケーリングルールを手動で実行するときに、ScalingRuleAri パラメーターを指定できます。

      • CreateScheduledTask 操作を呼び出してスケジュールに基づいてスケーリングルールを実行するときに、ScheduledAction パラメーターを指定できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ess:CreateScalingRule

    create

    *ScalingGroup

    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ScalingGroupId

    string

    必須

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

    asg-bp1ffogfdauy0jw0****
    ScalingRuleName

    string

    任意

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

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

    説明

    このパラメーターを指定しない場合、デフォルトで ScalingRuleId の値が使用されます。

    スケーリングルール****
    Cooldown

    integer

    任意

    スケーリングルールのクールダウン時間。このパラメーターは簡易スケーリングルールにのみ適用されます。有効な値: 0～86400。単位: 秒。

    デフォルト値: 空。

    60
    MinAdjustmentMagnitude

    integer

    任意

    スケーリングルールで調整するインスタンスの最小値。このパラメーターは、スケーリングルールのタイプが SimpleScalingRule または StepScalingRule であり、AdjustmentType が PercentChangeInCapacity に設定されている場合にのみ効果を発揮します。

    1
    AdjustmentType

    string

    任意

    スケーリングルールの調整方法。このパラメーターは簡易スケーリングルールおよびステップスケーリングルールに適用され、この場合は必須です。有効な値:

    • QuantityChangeInCapacity: 指定された数の ECS インスタンスを追加または削除します。

    • PercentChangeInCapacity: 指定された割合の ECS インスタンスを追加または削除します。

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

    QuantityChangeInCapacity
    AdjustmentValue

    integer

    任意

    スケーリングルールの調整値。このパラメーターは簡易スケーリングルールおよびステップスケーリングルールに適用され、この場合は必須です。1 回のスケーリングアクティビティで調整される ECS インスタンスの数は 1,000 を超えることはできません。有効な値は調整方法によって異なります。

    • QuantityChangeInCapacity: -1000～1000。

    • PercentChangeInCapacity: -100～10000。

    • TotalCapacity: 0～2000。

    100
    ScalingRuleType

    string

    任意

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

    • SimpleScalingRule: 簡易スケーリング。調整方法 (AdjustmentType) および調整値 (AdjustmentValue) に基づいて、ECS または ECI インスタンスの数を調整します。

    • TargetTrackingScalingRule: ターゲット追跡スケーリングルール。事前定義されたモニタリングメトリック (MetricName) に基づいてスケーリングする ECS または ECI インスタンスの数を動的に算出し、モニタリングメトリックの値をターゲット値 (TargetValue) に近づけるように試みます。

    • StepScalingRule: ステップスケーリングルール。しきい値とメトリック値に基づいてステップベースの拡張を提供します。

    • PredictiveScalingRule: 予測スケーリングルール。機械学習を使用してスケーリンググループの履歴モニタリングデータを分析し、将来のモニタリングメトリックの値を予測し、スケジュールされたタスクの自動作成をサポートしてスケーリンググループの境界を設定します。

    デフォルト値: SimpleScalingRule。

    SimpleScalingRule
    EstimatedInstanceWarmup

    integer

    任意

    インスタンスのウォームアップ期間。このパラメーターはターゲット追跡スケーリングルールおよびステップスケーリングルールに適用されます。ウォームアップ状態の ECS インスタンスは期待通りにスケーリンググループに追加されますが、ウォームアップ期間中はモニタリングデータが CloudMonitor にレポートされません。

    説明

    スケーリングする ECS インスタンスの数が動的に算出されるとき、ウォームアップ状態のインスタンスは現在のインスタンス数にカウントされません。

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

    デフォルト値: 300。

    300
    MetricName

    string

    任意

    事前定義メトリック。このパラメーターはターゲット追跡スケーリングルールおよび予測スケーリングルールに適用され、この場合は必須です。

    ターゲット追跡スケーリングルールの有効な値:

    • CpuUtilizationAgent: (エージェント) CPU 使用率 (推奨)。

    • MemoryUtilization: (エージェント) メモリ使用率 (推奨)。

    • CpuUtilization: (ECS) 平均 CPU 使用率。

    • IntranetTx: (ECS) 内部ネットワーク経由の平均アウトバウンドトラフィック。

    • IntranetRx: (ECS) 内部ネットワーク経由の平均インバウンドトラフィック。

    • VpcInternetTx: (ECS) インターネット経由の平均アウトバウンドトラフィック。

    • VpcInternetRx: (ECS) インターネット経由の平均インバウンドトラフィック。

    • LoadBalancerRealServerAverageQps: (ALB) サーバーグループ内のサーバーあたりの平均 QPS。

    予測スケーリングルールの有効な値:

    • CpuUtilization: (ECS) 平均 CPU 使用率。

    • IntranetRx: (ECS) 内部ネットワーク経由の平均インバウンドトラフィック。

    • IntranetTx: (ECS) 内部ネットワーク経由の平均アウトバウンドトラフィック。

    詳細については、「システムモニタリングのイベントトリガータスク」を参照してください。

    CpuUtilization
    TargetValue

    number

    任意

    ターゲット値。このパラメーターはターゲット追跡スケーリングルールおよび予測スケーリングルールに適用され、この場合は必須です。TargetValue の値は 10 進数で小数点以下 3 桁まで指定でき、0 より大きい値である必要があります。

    0.125
    DisableScaleIn

    boolean

    任意

    スケールインを無効にするかどうかを指定します。このパラメーターはターゲット追跡スケーリングルールにのみ適用されます。

    デフォルト値: false。

    false
    ScaleInEvaluationCount

    integer

    任意

    ターゲット追跡スケーリングルールの作成後、イベントトリガータスクが自動的に作成されます。このパラメーターは、スケールインイベントトリガータスクがアラートをトリガーする前に、条件付きのしきい値を満たす必要がある連続時間を指定します。

    デフォルト値: 15。

    15
    ScaleOutEvaluationCount

    integer

    任意

    ターゲット追跡スケーリングルールの作成後、イベントトリガータスクが自動的に作成されます。このパラメーターは、スケールアウトイベントトリガータスクがアラートをトリガーする前に、条件付きのしきい値を満たす必要がある連続時間を指定します。

    デフォルト値: 3。

    3
    PredictiveScalingMode

    string

    任意

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

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

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

    デフォルト値: PredictAndScale。

    PredictAndScale
    PredictiveValueBehavior

    string

    任意

    予測スケーリングルールの最大値を処理するために使用される方法。有効な値:

    • MaxOverridePredictiveValue: 初期最大値が予測値を上書きします。予測値が初期最大値より大きい場合、予測タスクの最大値は初期最大値に設定されます。

    • PredictiveValueOverrideMax: 予測値が初期最大値を上書きします。予測値が初期最大値より大きい場合、予測タスクの最大値は予測値に設定されます。

    • PredictiveValueOverrideMaxWithBuffer: 予測値が指定された割合だけ増加します。予測値は PredictiveValueBuffer の比率に基づいて増加します。増加した値が初期最大値より大きい場合、増加した値が使用されます。

    デフォルト値: MaxOverridePredictiveValue。

    MaxOverridePredictiveValue
    PredictiveValueBuffer

    integer

    任意

    このパラメーターは、PredictiveValueBehavior が PredictiveValueOverrideMaxWithBuffer に設定されている場合に効果を発揮します。予測値はこの比率に基づいて増加します。増加した値が初期最大値より大きい場合、増加した値が使用されます。有効な値: 0～100。

    デフォルト値: 0。

    50
    PredictiveTaskBufferTime

    integer

    任意

    予測スケーリングルールによって自動的に作成される予測タスクは、デフォルトで毎時 0 分に実行されます。予測タスクをスケジュールより前に実行するためにバッファー時間を設定し、リソースを事前に準備できます。有効な値: 0～60。単位: 分。

    デフォルト値: 0。

    30
    InitialMaxSize

    integer

    任意

    スケーリンググループ内のインスタンスの最大値。このパラメーターは PredictiveValueBehavior と一緒に使用されます。

    デフォルト値: スケーリンググループの MaxSize の値。

    100
    StepAdjustment

    array<object>

    任意

    ステップスケーリングルールのステップ調整情報のコレクション。

    object

    任意

    ステップスケーリングルールのステップ調整情報のコレクション。

    MetricIntervalUpperBound

    number

    任意

    ステップ調整の上限境界。このパラメーターはステップスケーリングルールにのみ適用されます。有効な値: -9.999999E18～9.999999E18。

    5.0
    ScalingAdjustment

    integer

    任意

    ステップ調整でスケーリングするインスタンスの数。このパラメーターはステップスケーリングルールにのみ適用されます。

    1
    MetricIntervalLowerBound

    number

    任意

    ステップ調整の下限境界。このパラメーターはステップスケーリングルールにのみ適用されます。有効な値: -9.999999E18～9.999999E18。

    1.0
    RegionId

    string

    任意

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

    cn-hangzhou
    AlarmDimension

    array<object>

    任意

    メトリックに関連付けられたディメンション情報。このパラメーターはターゲット追跡スケーリングルールに適用されます。メトリックに追加のディメンション情報が必要な場合に、このパラメーターを設定します。たとえば、LoadBalancerRealServerAverageQps メトリックには rulePool ディメンション情報が必要です。

    object

    任意

    メトリックに関連付けられたディメンション情報。このパラメーターはターゲット追跡スケーリングルールに適用されます。メトリックに追加のディメンション情報が必要な場合に、このパラメーターを設定します。たとえば、LoadBalancerRealServerAverageQps メトリックには rulePool ディメンション情報が必要です。

    DimensionKey

    string

    任意

    メトリックに関連付けられたディメンションのキー。

    ルールプール
    DimensionValue

    string

    任意

    メトリックに関連付けられたディメンションの値。

    sgp-l1cbirz451yxu2****
    MetricType

    string

    任意

    メトリックのタイプ。有効な値:

    • system: CloudMonitor システムメトリックを使用します。

    • custom: CloudMonitor にレポートされるカスタムメトリックを使用します。

    • hybrid: ハイブリッドクラウドモニタリングメトリックを使用します。

    system
    HybridMonitorNamespace

    string

    任意

    ハイブリッドクラウドモニタリングのモニタリングメトリックリポジトリの ID。

    メトリックリポジトリを管理するには、「メトリックリポジトリの管理」を参照してください。

    aliyun-test
    HybridMetrics

    array<object>

    任意

    ハイブリッドクラウドモニタリングのモニタリングメトリック設定。このパラメーターの設定方法の詳細については、「数式ベースのカスタムターゲット追跡スケーリングルールの使用」を参照してください。

    array<object>

    任意

    Id

    string

    任意

    メトリック式内のメトリックのリファレンス ID。

    a
    Expression

    string

    任意

    複数のハイブリッドクラウドモニタリングメトリックのメトリック式。式の計算結果は、スケーリングアクティビティをトリガーするために使用されます。

    式は逆ポーランド記法 (RPN) 仕様に準拠している必要があり、+ - * / 演算子のみがサポートされています。

    (a+b)/2
    MetricName

    string

    任意

    ハイブリッドクラウドモニタリングのモニタリングメトリックリポジトリ内のモニタリングメトリック名。

    AliyunSmq_NumberOfMessagesVisible
    Statistic

    string

    任意

    メトリックの統計方法。有効な値:

    • Average: 指定された間隔内のすべてのデータポイントの平均。

    • Minimum: 指定された間隔内のすべてのデータポイントの最小値。

    • Maximum: 指定された間隔内のすべてのデータポイントの最大値。

    Average
    Dimensions

    array<object>

    任意

    メトリックディメンション。メトリックをモニターするリソースを指定します。

    object

    任意

    DimensionKey

    string

    任意

    メトリックディメンションのキー。

    queue
    DimensionValue

    string

    任意

    メトリックディメンションの値。

    testQueue
    AlarmOptions

    object

    任意

    アラートプロパティの解像度。

    Period

    integer

    任意

    ターゲット追跡スケーリングルール内のモニタリングデータの統計期間。単位: 秒。有効な値:

    • 15。

    • 60。

    • 120。

    • 300。

    • 900。

    説明

    デフォルト値: 60。

    60

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ScalingRuleAri

    string

    スケーリングルールの一意な識別子。

    ari:acs:ess:cn-hangzhou:140692647406****:スケーリングルール/asr-bp1dvirgwkoowxk7****
    RequestId

    string

    リクエスト ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    ScalingRuleId

    string

    スケーリングルールの ID。ID はシステムによって生成され、グローバルに一意です。

    asr-bp1dvirgwkoowxk7****

    例

    成功レスポンス

    JSONJSON

    {
  "ScalingRuleAri": "ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingRuleId": "asr-bp1dvirgwkoowxk7****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。