すべてのプロダクト
Search
ドキュメントセンター

Auto Scaling:ModifyScalingRule

最終更新日:Oct 13, 2026

スケーリングルールの 1 つ以上の属性を変更します。既存のスケーリングルールが要件を満たさなくなった場合、新しいルールを作成する代わりにこの操作を呼び出して属性を変更できます。これにより、不要な繰り返しを防ぎ、時間とリソースを節約します。

今すぐお試しください

この 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:ModifyScalingRule

update

*スケーリンググループ。

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

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ScalingRuleId

string

必須

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

asr-bp1dvirgwkoowxk7****

ScalingRuleName

string

任意

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

説明

スケーリングルール名は、Alibaba Cloud アカウントのリージョン内のスケーリンググループ内で一意である必要があります。

scalingrule****

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

EstimatedInstanceWarmup

integer

任意

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

説明

システムがスケーリングする ECS インスタンスの数を動的に計算する際、ウォームアップ状態のインスタンスは既存のインスタンスとしてカウントされません。

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

60

MetricName

string

任意

事前定義メトリック。このパラメーターは、スケーリングルールがターゲット追跡スケーリングルールまたは予測スケーリングルールである場合に必須です。

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

  • CpuUtilizationAgent: CloudMonitor エージェントによって収集された CPU 使用率 (推奨)。

  • MemoryUtilization: CloudMonitor エージェントによって収集されたメモリ使用量 (推奨)。

  • CpuUtilization: ECS インスタンスの平均 CPU 使用率。

  • IntranetTx: ECS インスタンスの平均アウトバウンド内部トラフィック。

  • IntranetRx: ECS インスタンスの平均インバウンド内部トラフィック。

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

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

  • LoadBalancerRealServerAverageQps: ALB サーバーグループ内のバックエンドサーバーあたりの平均クエリ/秒 (QPS)。

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

  • CpuUtilization: ECS インスタンスの平均 CPU 使用率。

  • IntranetRx: ECS インスタンスの平均インバウンド内部トラフィック。

  • IntranetTx: ECS インスタンスの平均アウトバウンド内部トラフィック。

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

CpuUtilization

TargetValue

number

任意

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

0.125

DisableScaleIn

boolean

任意

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

true

ScaleInEvaluationCount

integer

任意

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

15

ScaleOutEvaluationCount

integer

任意

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

3

PredictiveScalingMode

string

任意

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

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

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

PredictAndScale

PredictiveValueBehavior

string

任意

予測スケーリングルールの最大値をハンドルするメソッド。有効な値:

  • MaxOverridePredictiveValue: 初期最大値が予測値を上書きします。予測値が初期最大値より大きい場合、初期最大値が予測タスクの最大値として使用されます。

  • PredictiveValueOverrideMax: 予測値が初期最大値を上書きします。予測値が初期最大値より大きい場合、予測値が予測タスクの最大値として使用されます。

  • PredictiveValueOverrideMaxWithBuffer: 予測値にバッファー比率が加算されます。予測値は、PredictiveValueBuffer で指定された比率だけ増加します。増加後の値が初期最大値より大きい場合、増加後の値が使用されます。

MaxOverridePredictiveValue

PredictiveValueBuffer

integer

任意

予測値に加算されるバッファー比率。このパラメーターは、PredictiveValueBehavior が PredictiveValueOverrideMaxWithBuffer に設定されている場合にのみ効果を発揮します。予測値はこの比率だけ増加します。増加後の値が初期最大値より大きい場合、増加後の値が使用されます。有効な値: 0~100。

50

PredictiveTaskBufferTime

integer

任意

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

30

InitialMaxSize

integer

任意

スケーリンググループ内のインスタンスの最大値。このパラメーターは、PredictiveValueBehavior と組み合わせて使用します。

100

StepAdjustment

array<object>

任意

ステップ調整のセット。

object

任意

ステップ調整のセット。

MetricIntervalUpperBound

number

任意

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

5.0

ScalingAdjustment

integer

任意

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

1

MetricIntervalLowerBound

number

任意

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

1.0

AlarmDimension

array<object>

任意

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

object

任意

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

DimensionKey

string

任意

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

rulePool

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

RequestId

string

リクエスト ID。

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

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

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

変更履歴

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