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

Auto Scaling:ModifyAlarm

最終更新日:Sep 17, 2026

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

操作説明

操作の説明

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

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

    • カスタム監視 (MetricType=custom) のイベントトリガータスクのメトリックは、ユーザーの監視メトリクスに依存します。

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

説明

ディメンション情報において、user_id と スケーリンググループ はシステムによって自動的に入力されます。デバイス と 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) 内部ネットワーク経由のアウトバウンドトラフィック (Kbit/min)。

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

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

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

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

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

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

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

    • 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) によって送信されたパケット数 (count/s)。

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

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

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

    • EciPodCpuUtilization: CPU 使用率 (%)。

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

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

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

MemoryUtilization

MetricType

string

任意

監視タイプ。有効な値:

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

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

system

Period

integer

任意

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

  • 15。

  • 60。

  • 120。

  • 300。

  • 900。

説明

15 秒の統計期間は、ECS タイプのスケーリンググループでのみサポートされます。

300

Statistics

string

任意

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

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

Average

Threshold

number

任意

監視メトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールがトリガーされます。

80

ComparisonOperator

string

任意

メトリック値としきい値の間の比較演算子。このパラメーターは、メトリック値がしきい値を満たす条件を指定します。有効な値:

  • メトリック値がしきい値以上。値: >=。

  • メトリック値がしきい値以下。値: <=。

  • メトリック値がしきい値より大きい。値: >。

  • メトリック値がしきい値より小さい。値: <。

>=

EvaluationCount

integer

任意

スケーリングルールがトリガーされる前に、しきい値の式が連続して満たされる必要がある回数。

たとえば、平均 CPU 使用率が 3 回の連続する統計期間にわたって 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 * * ?

AlarmAction

array

任意

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

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

string

任意

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

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

Dimension

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: クラシック VPC 接続インスタンスの場合、eth0 は内部 NIC を表します。VPC インスタンスの場合、eth0 NIC のみが存在します。

      • eth1: クラシック VPC 接続インスタンスの場合、eth1 はパブリック NIC を表します。

    • state:

      • TCP_TOTAL: TCP 接続の総数。

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

eth0

Expression

array<object>

任意

複数メトリックアラートルールに関する情報。

object

任意

複数メトリックアラートルールに関する情報。

MetricName

string

任意

複数メトリックアラートルールの監視メトリック名。有効な値は、イベントトリガーノードの監視タイプによって異なります。

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

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

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

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

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

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

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

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

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

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

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

    • 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) によって送信されたパケット数 (count/s)。

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

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

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

    • EciPodCpuUtilization: CPU 使用率 (%)。

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

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

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

CpuUtilization

ComparisonOperator

string

任意

複数メトリックアラートルールのメトリック値としきい値の間の比較演算子。このパラメーターは、メトリック値がしきい値を満たす条件を指定します。有効な値:

  • メトリック値がしきい値以上。値: >=。

  • メトリック値がしきい値以下。値: <=。

  • メトリック値がしきい値より大きい。値: >。

  • メトリック値がしきい値より小さい。値: <。

デフォルト値: >=。

>=

Period

integer

任意

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

  • 15。

  • 60。

  • 120。

  • 300。

  • 900。

説明

15 秒の統計期間は、ECS タイプのスケーリンググループでのみサポートされます。

デフォルト値: 300。

300

Statistics

string

任意

複数メトリックアラートルールでメトリックデータを集約するために使用されるメソッド。有効な値:

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

Average

Threshold

number

任意

複数メトリックアラートルールにおける監視メトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールがトリガーされます。

40.0

ExpressionsLogicOperator

string

任意

複数メトリックアラート条件間の論理演算子。有効な値:

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

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

デフォルト値: &&。

&&

レスポンスフィールド

フィールド

説明

object

AlarmTaskId

string

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

asg-bp1hvbnmkl10vll5****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

{
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****",
  "RequestId": "BACACF83-7070-4953-A8FD-D81F89F1****"
}

エラーコード

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

変更履歴

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