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

Auto Scaling:ModifyAlarm

最終更新日:May 21, 2026

イベントトリガータスクの変更

操作説明

  • カスタムモニタリングタイプのアラームタスク (MetricType=custom) を作成するには、まずカスタムモニタリングのメトリクスを CloudMonitor にレポートする必要があります。具体的な操作については、「カスタムモニタリングのアラームタスク」をご参照ください。

  • アラームタスクを作成する際、メトリック (MetricName) を指定し、ディメンション情報 (Dimension.N.DimensionKey と Dimension.N.DimensionValue) と組み合わせることで、スケーリンググループ内のメトリックデータの集計範囲を決定します。例えば、user_id と scaling_group のディメンションが使用され、特定のユーザーおよびスケーリンググループ配下にあるすべての ECS インスタンスまたは ECI インスタンスのメトリックデータが集計されます。
    • カスタムモニタリングのアラームタスク (MetricType=custom) のメトリックは、お客様独自の監視メトリクスによって決まります。

    • システムモニタリングのアラームタスク (MetricType=system) がサポートするメトリックの詳細については、「システムモニタリングのアラームタスク」をご参照ください。

説明

ディメンション情報では、user_id と scaling_group はシステムが自動的に入力し、device、state は手動で指定する必要があります。詳細については、パラメーター Dimension.N.DimensionKeyDimension.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

任意

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

alarmtask****

Description

string

任意

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

Test alarm task.

MetricName

string

任意

メトリクス名です。有効な値は、メトリクスタイプによって異なります。

  • MetricType パラメーターを custom に設定した場合、有効な値はお客様のカスタムメトリクスです。

  • MetricType パラメーターを system に設定した場合、MetricName パラメーターの有効な値は次のとおりです:

    • CpuUtilization:ECS インスタンスの CPU 使用率です。単位:%。

    • IntranetTx:ECS インスタンスから内部ネットワーク経由で送信されるアウトバウンドトラフィックです。単位:KB/min。

    • IntranetRx:ECS インスタンスが内部ネットワーク経由で受信するインバウンドトラフィックです。単位:KB/min。

    • VpcInternetTx:VPC に存在する ECS インスタンスからインターネット経由で送信されるアウトバウンドトラフィックです。単位:KB/min。

    • VpcInternetRx:VPC に存在する ECS インスタンスがインターネット経由で受信するインバウンドトラフィックです。単位:KB/min。

    • SystemDiskReadBps:ECS インスタンスが使用するシステムディスクから 1 秒あたりに読み取られるバイト数です。

    • SystemDiskWriteBps:ECS インスタンスが使用するシステムディスクに 1 秒あたりに書き込まれるバイト数です。

    • SystemDiskReadOps:ECS インスタンスが使用するシステムディスクに対する 1 秒あたりの読み取り操作数です。

    • SystemDiskWriteOps:ECS インスタンスが使用するシステムディスクに対する 1 秒あたりの書き込み操作数です。

    • CpuUtilizationAgent:エージェントの CPU 使用率です。単位:%。

    • GpuUtilizationAgent:エージェントの GPU 使用率です。単位:%。

    • GpuMemoryFreeUtilizationAgent:エージェントの GPU メモリのアイドル率です。

    • GpuMemoryUtilizationAgent:エージェントの GPU メモリ使用率です。単位:%。

    • MemoryUtilization:エージェントのメモリ使用率です。単位:%。

    • LoadAverage:エージェントの平均システム負荷です。

    • TcpConnection:エージェントの TCP 接続数です。Dimensions パラメーターで state を指定することで、TCP 接続の総数 (TCP_TOTAL) または確立済み TCP 接続数 (ESTABLISHED) を取得できます。

    • PackagesNetOut:エージェントが使用する内部ネットワークインターフェイスコントローラー (NIC) から送信されるパケット数です。

    • PackagesNetIn:エージェントが使用する内部ネットワークインターフェイスコントローラー (NIC) で受信されるパケット数です。

    • EciPodCpuUtilization:Elastic Container Instance の CPU 使用率です。単位:%。

    • EciPodMemoryUtilization:Elastic Container Instance のメモリ使用率です。単位:%。

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

MemoryUtilization

MetricType

string

任意

メトリクスのタイプです。有効な値:

  • system:CloudMonitor のシステムメトリクスです。

  • custom:CloudMonitor にレポートされるカスタムメトリクスです。

system

Period

integer

任意

メトリクスの統計情報を収集する期間です。単位:秒。有効な値:

  • 15

  • 60

  • 120

  • 300

  • 900

説明

スケーリンググループが ECS タイプで、CloudMonitor メトリクスを使用している場合は、Period パラメーターを 15 に設定できます。それ以外の場合は、Period パラメーターを 60、120、300、または 900 に設定できます。多くの場合、CloudMonitor メトリクス名にはエージェントが含まれます。

300

Statistics

string

任意

メトリクスの統計を集計する方法です。有効な値:

  • Average

  • Minimum

  • Maximum

Average

Threshold

number

任意

複数メトリクスのアラートルールにおけるメトリクス値のしきい値です。指定した期間内にメトリクス値がしきい値に指定回数到達すると、スケーリングルールが実行されます。

80

ComparisonOperator

string

任意

メトリクス値としきい値を比較するために使用する比較演算子です。有効な値:

  • メトリクス値がしきい値以上の場合は、>= を指定します。

  • メトリクス値がしきい値以下の場合は、<= を指定します。

  • メトリクス値がしきい値を上回る場合は、> を指定します。

  • メトリクス値がしきい値を下回る場合は、< を指定します。

>=

EvaluationCount

integer

任意

スケーリングルールが実行されるまでに、メトリクス値がしきい値に到達する必要がある回数です。たとえば、このパラメーターを 3 に設定した場合、平均 CPU 使用率が 80% に 3 回連続で到達または超過した後に、スケーリングルールがトリガーされます。

3

GroupId

integer

任意

カスタムメトリクスが属するアプリケーショングループの 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 * * ? は、イベントトリガー型タスクが毎日 01:00~02:59 (UTC+0) の間に有効であることを示します。

例:

  • * * * * * ? :イベントトリガー型タスクは常に有効です。

  • * * 17-18 * * ? :イベントトリガー型タスクは毎日 17:00~18:59 (UTC+8) の間に有効です。

  • TZ=+00 * * 1-2 * * ?: イベントトリガーのタスクは、毎日 01:00 から 02:59 (UTC+0) の間有効です。

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

AlarmActions

array

任意

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

string

任意

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

ari:acs:ess:cn-hangzhou:140692647****:scalingrule/asr-bp163l21e07uhn****

Dimensions

array<object>

任意

メトリクスのディメンションです。

object

任意

メトリクスのディメンションです。

DimensionKey

string

任意

メトリクスに関連付けるディメンション N のキーです。Dimension.N.DimensionKey の有効な値は、MetricType の値によって異なります。

  • MetricTypecustom に設定した場合は、ビジネス要件に基づいてこのパラメーターを指定できます。

  • MetricTypesystem に設定した場合、このパラメーターの有効な値は次のとおりです:

    • user_id:Alibaba Cloud アカウントの ID です。

    • scaling_group:イベントトリガー型タスクによって監視されるスケーリンググループです。

    • device:NIC タイプです。

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

    • rulePool:ALB qps メトリクスに対して指定されたサーバーグループです。

device

DimensionValue

string

任意

メトリクスのディメンションの値です。このパラメーターの有効な値は、Dimensions.DimensionKey の値によって異なります。

  • MetricTypecustom に設定した場合は、ビジネス要件に基づいてこのパラメーターを指定できます。

  • MetricTypesystem に設定した場合、Dimension.N.DimensionValue の有効な値は次のとおりです:

    • user_id:値はシステムによって指定されます。

    • scaling_group:値はシステムによって指定されます。

    • device:

      • eth0:クラシックネットワークインスタンスの場合、eth0 は内部ネットワークのネットワークインターフェイスコントローラー (NIC) を表します。VPC に存在する各インスタンスには、eth0 NIC が 1 つだけ存在します。

      • eth1:クラシックネットワークインスタンスの場合、eth1 はインターネットのネットワークインターフェイスコントローラー (NIC) を表します。

    • state:

      • TCP_TOTAL は TCP 接続の総数を表します。

      • ESTABLISHED は確立済み TCP 接続数を表します。

eth0

Expressions

array<object>

任意

複数メトリクスのアラートルールで指定される式です。

object

任意

複数メトリクスのアラートルールで指定される式です。

MetricName

string

任意

複数メトリクスのアラートルールで指定されるメトリクス名です。有効な値は、メトリクスタイプによって異なります。

  • MetricType パラメーターを custom に設定した場合、有効な値はお客様のカスタムメトリクスです。

  • MetricType パラメーターを system に設定した場合、MetricName パラメーターの有効な値は次のとおりです:

    • CpuUtilization:ECS インスタンスの CPU 使用率です。単位:%。

    • IntranetTx:ECS インスタンスから内部ネットワーク経由で送信されるアウトバウンドトラフィックです。単位:KB/min。

    • IntranetRx:ECS インスタンスが内部ネットワーク経由で受信するインバウンドトラフィックです。単位:KB/min。

    • VpcInternetTx:VPC に存在する ECS インスタンスからインターネット経由で送信されるアウトバウンドトラフィックです。単位:KB/min。

    • VpcInternetRx:VPC に存在する ECS インスタンスがインターネット経由で受信するインバウンドトラフィックです。単位:KB/min。

    • SystemDiskReadBps:ECS インスタンスが使用するシステムディスクから 1 秒あたりに読み取られるバイト数です。

    • SystemDiskWriteBps:ECS インスタンスが使用するシステムディスクに 1 秒あたりに書き込まれるバイト数です。

    • SystemDiskReadOps:ECS インスタンスが使用するシステムディスクに対する 1 秒あたりの読み取り操作数です。

    • SystemDiskWriteOps:ECS インスタンスが使用するシステムディスクに対する 1 秒あたりの書き込み操作数です。

    • CpuUtilizationAgent:エージェントの CPU 使用率です。単位:%。

    • GpuUtilizationAgent:エージェントの GPU 使用率です。単位:%。

    • GpuMemoryFreeUtilizationAgent:エージェントの GPU メモリのアイドル率です。

    • GpuMemoryUtilizationAgent:エージェントの GPU メモリ使用率です。単位:%。

    • MemoryUtilization:エージェントのメモリ使用率です。単位:%。

    • LoadAverage:エージェントの平均システム負荷です。

    • TcpConnection:エージェントの TCP 接続数です。Dimensions パラメーターで state を指定することで、TCP 接続の総数 (TCP_TOTAL) または確立済み TCP 接続数 (ESTABLISHED) を取得できます。

    • PackagesNetOut:エージェントが使用する内部ネットワークインターフェイスコントローラー (NIC) から送信されるパケット数です。

    • PackagesNetIn:エージェントが使用する内部ネットワークインターフェイスコントローラー (NIC) で受信されるパケット数です。

    • EciPodCpuUtilization:Elastic Container Instance の CPU 使用率です。単位:%。

    • EciPodMemoryUtilization:Elastic Container Instance のメモリ使用率です。単位:%。

    • EciPodMemoryUtilization: エラスティックコンテナインスタンスのメモリ使用量。単位: %。

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

CpuUtilization

ComparisonOperator

string

任意

メトリクス値としきい値を比較するために使用する比較演算子です。有効な値:

  • メトリクス値がしきい値以上の場合は、>= を指定します。

  • メトリクス値がしきい値以下の場合は、<= を指定します。

  • メトリクス値がしきい値を上回る場合は、> を指定します。

  • メトリクス値がしきい値を下回る場合は、< を指定します。

デフォルト値は >= です。

>=

Period

integer

任意

複数メトリクスのアラートルールにおけるメトリクスの統計情報を収集する期間です。単位:秒。有効な値:

  • 15

  • 60

  • 120

  • 300

  • 900

説明

スケーリンググループが ECS タイプで、かつ関連付けられたイベントトリガー型タスクが CloudMonitor メトリクスを監視している場合は、Period パラメーターを 15 に設定できます。それ以外の場合は、Period パラメーターを 60、120、300、または 900 に設定できます。多くの場合、CloudMonitor メトリクス名にはエージェントが含まれます。

デフォルト値は 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****"
}

エラーコード

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

変更履歴

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