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

Auto Scaling:ModifyAlarm

最終更新日:Sep 10, 2026

イベントトリガータスクを変更します。

操作説明

  • カスタム監視タイプ (MetricType=custom) のイベントトリガータスクを作成する場合は、まずカスタム監視メトリクスを CloudMonitor にレポートする必要があります。詳細については、「カスタム監視のイベントトリガータスク」を参照してください。

  • イベントトリガータスクを作成するときは、メトリック (MetricName) を指定し、ディメンション情報 (Dimension.N.DimensionKey および Dimension.N.DimensionValue) を設定して、スケーリンググループ内のメトリックデータの集約範囲を決定する必要があります。たとえば、user_id と scaling_group を指定して、指定されたユーザーのスケーリンググループ内のすべての ECS インスタンスまたはエラスティックコンテナインスタンスのメトリックデータを集約できます。
    • カスタム監視イベントトリガータスク (MetricType=custom) のメトリックは、カスタム監視メトリクスに依存します。

    • システムモニタリングイベントトリガータスク (MetricType=system) でサポートされているメトリックの詳細については、「システムモニタリングのイベントトリガータスク」を参照してください。

説明

ディメンション情報では、user_id と scaling_group はシステムによって自動的に入力されます。デバイスと state は手動で指定する必要があります。詳細については、Dimension.N.DimensionKey パラメーターおよび Dimension.N.DimensionValue パラメーターを参照してください。

今すぐお試しください

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

update

*ScalingGroup。

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

イベントトリガータスクのリージョン ID。

cn-qingdao

AlarmTaskId

string

必須

イベントトリガータスクの ID。

asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****

Name

string

任意

イベントトリガータスクの名前。

アラームタスク****

Description

string

任意

イベントトリガータスクの説明。

テストアラームタスク

MetricName

string

任意

メトリックの名前。有効な値は、イベントトリガータスクのモニタリングタイプによって異なります。

  • イベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、有効な値はカスタムメトリックです。

  • イベントトリガータスクがシステムモニタリングタイプ (MetricType=system) の場合、有効な値:

    • CpuUtilization: (ECS) CPU 使用率 (%)。

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

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

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

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

    • SystemDiskReadBps: (ECS) システムクラウドディスク読み取り BPS (Byte/s)。

    • SystemDiskWriteBps: (ECS) システムクラウドディスク書き込み BPS (Byte/s)。

    • SystemDiskReadOps: (ECS) システムクラウドディスク読み取り IOPS (回/秒)。

    • SystemDiskWriteOps: (ECS) システムクラウドディスク書き込み IOPS (回/秒)。

    • CpuUtilizationAgent: (Agent) CPU 使用率 (%)。

    • GpuMemoryFreeUtilizationAgent: (Agent) GPU メモリアイドルレート (%)。

    • GpuMemoryUtilizationAgent: (Agent) GPU メモリ使用率 (%)。

    • MemoryUtilization: (Agent) メモリ使用率 (%)。

    • LoadAverage: (Agent) 平均システムロード。

    • TcpConnection: (Agent) TCP 接続の合計数。

    • TcpConnection: (Agent) 確立された TCP 接続数。

    • PackagesNetOut: (Agent) ネットワークインターフェースコントローラー (NIC) によって送信されたパケット数。

    • PackagesNetIn: (Agent) ネットワークインターフェースコントローラー (NIC) によって受信されたパケット数。

    • EciPodCpuUtilization: CPU 使用率 (%)。

    • EciPodMemoryUtilization: メモリ使用率 (%)。

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

MemoryUtilization

MetricType

string

任意

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

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

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

system

Period

integer

任意

メトリックデータの統計期間 (秒単位)。有効な値:

  • 15。

  • 60。

  • 120。

  • 300。

  • 900。

説明

15 秒の統計期間は、ECS タイプのスケーリンググループをモニタリングするときに CloudMonitor エージェントによって収集されたメトリック (Agent で始まるメトリック) にのみ適用されます。他のすべてのメトリックでは、統計期間を 60、120、300、または 900 秒に設定できます。

300

Statistics

string

任意

メトリックデータの集約に使用されるメソッド。有効な値:

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

Average

Threshold

number

任意

複数メトリックイベントトリガータスクにおけるモニタリングメトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールが実行されます。

80

ComparisonOperator

string

任意

メトリックの統計値としきい値の間の比較演算子。比較演算子は、統計値としきい値が条件を満たすことができる関係を示します。有効な値:

  • 統計値がしきい値以上。値: >=

  • 統計値がしきい値以下。値: <=

  • 統計値がしきい値より大きい。値: >

  • 統計値がしきい値より小さい。値: <

>=

EvaluationCount

integer

任意

スケーリングルールがトリガーされる前に、しきい値の式が満たされる必要がある回数。たとえば、3 回の連続する統計結果において、平均 CPU 使用率が 80% 以上である必要があります。

3

GroupId

integer

任意

カスタムメトリックが属する CloudMonitor アプリケーショングループの ID。このパラメーターは、MetricType が custom に設定されている場合にのみ必須です。

4055401

Effective

string

任意

イベントトリガータスクの有効期間を指定します。

このパラメーターは cron 式に従います。デフォルトのフォーマットは X X X X X ? です。ここで、

  • X: フィールドのプレースホルダーで、秒、分、時間、日、月の順に表します。X には、特定の値または論理的な意味を持つ特殊文字を指定できます。X の有効な値の詳細については、「cron 式」を参照してください。

  • ?: 値を指定しないことを示します。

説明

このパラメーターの値は、デフォルトで協定世界時 (UTC)+8 タイムゾーンです。cron 式の前にタイムゾーン情報 TZ=+yy を追加してタイムゾーンを指定できます。y はタイムゾーンの数値を表します。たとえば、TZ=+00 * * 1-2 * * ? は、イベントトリガータスクが協定世界時 (UTC)+0 タイムゾーンで毎日 01:00 から 02:59 の間で効果があることを示します。

例と説明:

  • * * * * * ? : 常に効果がある。

  • * * 17-18 * * ? : 協定世界時 (UTC)+8 タイムゾーンで毎日 17:00 から 18:59 の間で効果がある。

  • TZ=+00 * * 1-2 * * ?: 協定世界時 (UTC)+0 タイムゾーンで毎日 01:00 から 02:59 の間で効果がある。

TZ=+00 * * 1-2 * * ?

AlarmActions

array

任意

イベントトリガータスクに関連付けられているスケーリングルールの一意の識別子のリスト。

string

任意

イベントトリガータスクに関連付けられているスケーリングルールの一意の識別子のリスト。

ari:acs:ess:cn-hangzhou:140692647****:スケーリングルール/asr-bp163l21e07uhn****

Dimensions

array<object>

任意

メトリックに関連付けられているディメンション情報。

object

任意

メトリックに関連付けられているディメンション情報。

DimensionKey

string

任意

メトリックに関連付けられているディメンション情報のキー。有効な値は、イベントトリガーノードのモニタリングタイプによって異なります。

  • イベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、有効な値に制限はありません。カスタム値を指定できます。

  • イベントトリガータスクがシステムモニタリングタイプ (MetricType=system) の場合、有効な値:

    • user_id: アカウント ID。

    • scaling_group: 監視対象のスケーリンググループ。

    • device: ネットワークインターフェースコントローラー (NIC) デバイスのタイプ。

    • state: TCP 接続のステータス。

    • ルールプール: ALB QPS モニタリングメトリクスに指定されたサーバーグループ。

デバイス

DimensionValue

string

任意

メトリックに関連付けられているディメンション情報の値。有効な値は Dimension.N.DimensionKey によって決まります。

  • Dimension.N.DimensionKey がカスタム値に設定されている場合、つまりイベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、有効な値に制限はありません。カスタム値を指定できます。

  • Dimension.N.DimensionKey がシステム指定値に設定されている場合、つまりイベントトリガータスクがシステムモニタリングタイプ (MetricType=system) の場合、有効な値:

    • user_id: システムによって自動的に入力されます。

    • スケーリンググループ: システムによって自動的に入力されます。

    • デバイス:

      • eth0: クラシックネットワークインスタンスの場合、eth0 は内部 NIC を表します。VPC 接続インスタンスの場合、eth0 NIC のみが存在します。

      • eth1: クラシックネットワークインスタンスの場合、eth1 はパブリック NIC を表します。

    • state:

      • TCP_TOTAL: TCP 接続の合計数。

      • ESTABLISHED: 確立された TCP 接続数。

eth0

Expressions

array<object>

任意

複数メトリックイベントトリガータスクのモニタリングメトリクス。

object

任意

複数メトリックイベントトリガータスクのモニタリングメトリクス。

ComparisonOperator

string

任意

メトリックの統計値としきい値の間の比較演算子。比較演算子は、統計値としきい値が条件を満たすことができる関係を示します。有効な値:

  • 統計値がしきい値以上。値: >=

  • 統計値がしきい値以下。値: <=

  • 統計値がしきい値より大きい。値: >

  • 統計値がしきい値より小さい。値: <

デフォルト値: >=。

>=

MetricName

string

任意

複数メトリックイベントトリガーノードにおけるモニタリングメトリクスの名前。有効な値は、イベントトリガータスクのモニタリングタイプによって異なります。

  • イベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、有効な値はカスタム監視メトリクスです。

  • イベントトリガータスクがシステムモニタリングタイプ (MetricType=system) の場合、有効な値:

    • CpuUtilization: (ECS) CPU 使用率 (%)。

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

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

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

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

    • SystemDiskReadBps: (ECS) システムクラウドディスク読み取り BPS (Byte/s)。

    • SystemDiskWriteBps: (ECS) システムクラウドディスク書き込み BPS (Byte/s)。

    • SystemDiskReadOps: (ECS) システムクラウドディスク読み取り IOPS (回/秒)。

    • SystemDiskWriteOps: (ECS) システムクラウドディスク書き込み IOPS (回/秒)。

    • CpuUtilizationAgent: (Agent) CPU 使用率 (%)。

    • GpuUtilizationAgent: (Agent) GPU 使用率 (%)。

    • GpuMemoryFreeUtilizationAgent: (Agent) GPU メモリアイドルレート (%)。

    • GpuMemoryUtilizationAgent: (Agent) GPU メモリ使用率 (%)。

    • MemoryUtilization: (Agent) メモリ使用率 (%)。

    • LoadAverage: (Agent) 平均システムロード。

    • TcpConnection: (Agent) TCP 接続の合計数。

    • TcpConnection: (Agent) 確立された TCP 接続数。

    • PackagesNetOut: (Agent) ネットワークインターフェースコントローラー (NIC) によって送信されたパケット数。

    • PackagesNetIn: (Agent) ネットワークインターフェースコントローラー (NIC) によって受信されたパケット数。

    • EciPodCpuUtilization: CPU 使用率 (%)。

    • EciPodMemoryUtilization: メモリ使用率 (%)。

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

CpuUtilization

Period

integer

任意

複数メトリックイベントトリガータスクにおけるメトリックデータの統計期間 (秒単位)。有効な値:

  • 15。

  • 60。

  • 120。

  • 300。

  • 900。

説明

15 秒の統計期間は、ECS タイプのスケーリンググループをモニタリングするときに CloudMonitor エージェントによって収集されたメトリック (Agent で始まるメトリック) にのみ適用されます。他のすべてのメトリックでは、統計期間を 60、120、300、または 900 秒に設定できます。

デフォルト値: 300。

300

Statistics

string

任意

複数メトリックイベントトリガータスクにおけるメトリックデータの集約に使用されるメソッド。有効な値:

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

Average

Threshold

number

任意

複数メトリックイベントトリガータスクにおけるモニタリングメトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールが実行されます。

40.0

ExpressionsLogicOperator

string

任意

複数のモニタリングメトリクス条件間の関係。有効な値:

  • &&: すべてのモニタリングメトリクスがアラート条件を満たした場合にのみアラートがトリガーされます。複数メトリックイベントトリガータスク内のすべての式が true と評価された場合にのみアラートがトリガーされます。

  • ||: いずれかのモニタリングメトリクスがアラート条件を満たした場合にアラートがトリガーされます。

デフォルト値: &&

&&

レスポンスフィールド

フィールド

説明

object

AlarmTaskId

string

イベントトリガータスクの ID。

asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****

RequestId

string

リクエスト ID。

BACACF83-7070-4953-A8FD-D81F89F1****

成功レスポンス

JSONJSON

{
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****",
  "RequestId": "BACACF83-7070-4953-A8FD-D81F89F1****"
}

エラーコード

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

変更履歴

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