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

Auto Scaling:ModifyScalingRule

最終更新日:Sep 10, 2026

スケーリングルールを変更します。

今すぐお試しください

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

*ScalingGroup

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 で、AdjustmentTypePercentChangeInCapacity にセットされている場合にのみ効果があります。

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: (エージェント) 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

任意

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

true

ScaleInEvaluationCount

integer

任意

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

15

ScaleOutEvaluationCount

integer

任意

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

3

PredictiveScalingMode

string

任意

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

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

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

PredictAndScale

PredictiveValueBehavior

string

任意

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

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

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

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

MaxOverridePredictiveValue

PredictiveValueBuffer

integer

任意

このパラメーターは、PredictiveValueBehaviorPredictiveValueOverrideMaxWithBuffer にセットされている場合に効果があります。予測値はこの割合で増加されます。増加後の値が初期最大値より大きい場合、増加後の値が使用されます。有効な値: 0~100。

50

PredictiveTaskBufferTime

integer

任意

予測スケーリングルールによって自動的に作成された予測タスクは、デフォルトで毎正時に実行されます。バッファー時間を設定して、予測タスクを前倒しで実行し、リソースを事前に準備できます。有効な値: 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****"
}

エラーコード

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

変更履歴

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