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

Auto Scaling:CreateAlarm

最終更新日: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:CreateAlarm

create

*ScalingGroup

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

スケーリンググループのリージョン ID。

cn-hangzhou

Name

string

任意

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

TestAlarmTask

Description

string

任意

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

Test alarm task.

ScalingGroupId

string

必須

イベントトリガータスクに関連付けられたスケーリンググループの ID。

asg-bp18p2yfxow2dloq****

MetricName

string

任意

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

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

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

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

    • ConcurrentConnections: (ECS) ECS インスタンスへの同時接続数。

    • 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: (エージェント) CPU 使用率 (%)。

    • GpuUtilizationAgent: (エージェント) GPU 使用率 (%)。

    • GpuMemoryFreeUtilizationAgent: (エージェント) GPU メモリアイドルレート (%)。

    • GpuMemoryUtilizationAgent: (エージェント) GPU メモリ使用率 (%)。

    • MemoryUtilization: (エージェント) メモリ使用率 (%)。

    • LoadAverage: (エージェント) 平均システムロード。

    • TcpConnection: (エージェント) TCP 接続の合計数。

    • TcpConnection: (エージェント) 確立済み TCP 接続数。

    • PackagesNetOut: (エージェント) 内部 NIC から送信されたパケット数 (count/s)。

    • PackagesNetIn: (エージェント) 内部 NIC で受信されたパケット数 (count/s)。

    • PackagesNetOut: (エージェント) パブリック NIC から送信されたパケット数 (count/s)。

    • PackagesNetIn: (エージェント) パブリック NIC で受信されたパケット数 (count/s)。

    • EciPodCpuUtilization: CPU 使用率 (%)。

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

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

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

CpuUtilization

MetricType

string

任意

モニタリングメトリックのタイプ。有効な値:

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

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

system

Period

integer

任意

モニタリングメトリックデータの統計期間。単位: 秒。有効な値:

  • 15

  • 60

  • 120

  • 300

  • 900

説明

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

デフォルト値: 300。

300

Statistics

string

任意

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

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

デフォルト値: Average。

Average

Threshold

number

任意

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

80.0

ComparisonOperator

string

任意

モニタリングメトリックの集約値としきい値の間の比較演算子。このパラメーターは、条件が満たされる関係を指定します。有効な値:

  • 集約値がしきい値以上。値: >=。

  • 集約値がしきい値以下。値: <=。

  • 集約値がしきい値より大きい。値: >。

  • 集約値がしきい値より小さい。値: <。

デフォルト値: >=。

>=

EvaluationCount

integer

任意

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

デフォルト値: 3。

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:1406926****:scalingrule/asr-bp163l21e07uhn****

string

任意

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

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

Dimension

array<object>

任意

モニタリングメトリックに関連付けられたディメンションのリスト。

object

任意

モニタリングメトリックに関連付けられたディメンションのリスト。

DimensionKey

string

任意

監視メトリクスに関連付けられたディメンションのキー。有効な値はイベントトリガータスクのモニタリングタイプによって異なります:

  • イベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、任意の値を指定できます。

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

    • user_id: アカウント ID。

    • scaling_group: モニタリング対象のスケーリンググループ。

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

    • state: TCP 接続の状態。

    • rulePool: ALB QPS 監視メトリクスノードに指定されたサーバーグループ。

device

DimensionValue

string

任意

監視メトリクスに関連付けられたディメンションの値。有効な値は Dimension.N.DimensionKey によって決まります:

  • Dimension.N.DimensionKey がカスタム値の場合、つまりイベントトリガータスクがカスタム監視タイプ (MetricType=custom) の場合、任意の値を指定できます。

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

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

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

    • device:

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

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

    • state:

      • TCP_TOTAL: TCP 接続の合計数。

      • ESTABLISHED: 確立済み TCP 接続数。

    • rulePool: ALB サーバーグループの ID。例: sgp-xxxxx。

eth0

Expression

array<object>

任意

マルチメトリックアラートルールの情報。

object

任意

マルチメトリックアラートルールの情報。

MetricName

string

任意

マルチメトリックアラートルールの監視メトリクスの名前。有効な値はイベントトリガータスクのモニタリングタイプによって異なります:

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

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

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

    • ConcurrentConnections: (ECS) ECS インスタンスへの同時接続数。

    • 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: (エージェント) CPU 使用率 (%)。

    • GpuUtilizationAgent: (エージェント) GPU 使用率 (%)。

    • GpuMemoryFreeUtilizationAgent: (エージェント) GPU メモリアイドルレート (%)。

    • GpuMemoryUtilizationAgent: (エージェント) GPU メモリ使用率 (%)。

    • MemoryUtilization: (エージェント) メモリ使用率 (%)。

    • LoadAverage: (エージェント) 平均システムロード。

    • TcpConnection: (エージェント) TCP 接続の合計数。

    • TcpConnection: (エージェント) 確立済み TCP 接続数。

    • PackagesNetOut: (エージェント) 内部 NIC から送信されたパケット数 (count/s)。

    • PackagesNetIn: (エージェント) 内部 NIC で受信されたパケット数 (count/s)。

    • PackagesNetOut: (エージェント) パブリック NIC から送信されたパケット数 (count/s)。

    • PackagesNetIn: (エージェント) パブリック NIC で受信されたパケット数 (count/s)。

    • EciPodCpuUtilization: CPU 使用率 (%)。

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

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

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

CpuUtilization

ComparisonOperator

string

任意

マルチメトリックアラートルールにおけるモニタリングメトリックの集約値としきい値の間の比較演算子。このパラメーターは、条件が満たされる関係を指定します。有効な値:

  • 集約値がしきい値以上。値: >=。

  • 集約値がしきい値以下。値: <=。

  • 集約値がしきい値より大きい。値: >。

  • 集約値がしきい値より小さい。値: <。

デフォルト値: >=。

>=

Period

integer

任意

マルチメトリックアラートルールにおけるモニタリングメトリックデータの統計期間。単位: 秒。有効な値:

  • 15

  • 60

  • 120

  • 300

  • 900

説明

15 秒の統計期間をサポートするのは ECS タイプのスケーリンググループのみです。 デフォルト値: 300。

900

Statistics

string

任意

マルチメトリックアラートルールにおけるモニタリングメトリックデータの集約に使用されるメソッド。有効な値:

  • Average: 平均値。

  • Minimum: 最小値。

  • Maximum: 最大値。

デフォルト値: Average。

Average

Threshold

number

任意

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

40.0

ExpressionsLogicOperator

string

任意

複数の監視メトリクスアラート条件間の関係。有効な値:

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

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

デフォルト値: &&

&&

レスポンスフィールド

フィールド

説明

object

AlarmTaskId

string

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

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

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

{
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

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

変更履歴

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