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

Auto Scaling:CreateAlarm

最終更新日:May 22, 2026

監視タスクを作成します。ビジネスで予期しないトラフィックの急増が発生する場合や、特定のパターンがない場合は、CreateAlarm 操作を呼び出して監視タスクを作成し、CloudMonitor メトリックをそのタスクに関連付けることができます。これにより、スケーリンググループ内の Elastic Compute Service (ECS) インスタンスまたはエラスティックコンテナインスタンスの数を動的に調整し、リアルタイムのメトリックデータを常に把握することで、クラウドリソースの管理とメンテナンスが容易になります。

操作説明

  • MetricType を custom に設定する場合、カスタムメトリックを使用して監視タスクを作成する前に、あらかじめ CloudMonitor にカスタムメトリックをレポートしておく必要があります。詳細については、「カスタム監視タイプの監視タスク」をご参照ください。

  • 監視タスクを作成する際は、スケーリンググループのメトリックを集計する統計範囲を決定するために、MetricName、Dimensions.DimensionKey、および Dimensions.DimensionValue を指定する必要があります。たとえば、Alibaba Cloud アカウント内のスケーリンググループに属するすべての ECS インスタンスまたはエラスティックコンテナインスタンスのモニタリングデータを集計するために、user_id および scaling_group を指定できます。

    • カスタム監視タイプの監視タスクを作成する場合、タスク内で指定できるのはカスタムメトリックのみです。

    • システム監視タイプの監視タスクを作成する場合、タスク内で「システム監視タイプの監視タスク」に記載されているシステムメトリックを指定できます。

説明

user_id および scaling_group は自動的に設定されます。指定が必要なのは device および state のみです。詳細については、本トピックの「リクエストパラメーター」セクションにある Dimensions.DimensionKey および Dimensions.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:CPU 使用率。単位:%。

    • ConcurrentConnections:同時接続数。

    • IntranetTx:内部ネットワークのアウトバウンドトラフィック。単位:KB/分。

    • IntranetRx:内部ネットワークのインバウンドトラフィック。単位:KB/分。

    • VpcInternetTx:VPC のアウトバウンドトラフィック。単位:KB/分。

    • VpcInternetRx:VPC のインバウンドトラフィック。単位:KB/分。

    • SystemDiskReadBps:システムディスクから 1 秒間に読み取られるバイト数。

    • SystemDiskWriteBps:システムディスクに 1 秒間に書き込まれるバイト数。

    • SystemDiskReadOps:システムディスクの読み取り IOPS。単位:回/s。

    • SystemDiskWriteOps:システムディスクの書き込み IOPS。単位:回/s。

    • CpuUtilizationAgent:CPU 使用率。単位:%。

    • GpuUtilizationAgent:GPU 使用率。単位:%。

    • GpuMemoryFreeUtilizationAgent:アイドル GPU メモリ使用率。単位:%。

    • GpuMemoryUtilizationAgent:GPU メモリ使用率。単位:%。

    • MemoryUtilization:メモリ使用量。単位:%。

    • LoadAverage:システム平均負荷。

    • TcpConnection:TCP 接続総数。

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

    • PackagesNetOut:内部 NIC から送信されるパケット数。単位:回/s。

    • PackagesNetIn:内部 NIC で受信されるパケット数。単位:回/s。

    • PackagesNetOut:パブリック NIC から送信されるパケット数。単位:回/s。

    • PackagesNetIn:パブリック NIC で受信されるパケット数。単位:回/s。

    • EciPodCpuUtilization:CPU 使用率。単位:%。

    • EciPodMemoryUtilization:メモリ使用量。単位:%。

    • LoadBalancerRealServerAverageQps:インスタンスの秒間クエリ数 (QPS)。

詳細については、「システム監視タイプの監視タスク」をご参照ください。

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

任意

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

デフォルト値:3。

3

GroupId

integer

任意

カスタムメトリックが属するアプリケーショングループの ID です。MetricType パラメーターを custom に設定する場合、このパラメーターを指定する必要があります。

4055401

Effective

string

任意

監視タスクの有効期間です。デフォルトでは、監視タスクは常時有効になります。

このパラメーターは cron 式の形式に従います。デフォルト形式は X X X X X ? です。この形式において:

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

  • ?:値を指定しません。

説明

デフォルトでは、このパラメーターの値は UTC + 08:00 で指定されます。cron 式の前に TZ=+yy 形式でタイムゾーンを指定できます。y はタイムゾーンを示します。たとえば、TZ=+00 * * 1-2 * * ? は、監視タスクが毎日 01:00~02:59 (UTC + 00:00) の間に有効になることを意味します。

サンプル値:

  • * * * * * ? :監視タスクは常時有効です。

  • * * 17-18 * * ? :監視タスクは毎日 17:00~18:59 (UTC + 08:00) の間に有効です。

  • TZ=+00 * * 1-2 * * ?:監視タスクは毎日 01:00~02:59 (UTC + 00:00) の間に有効です。

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

AlarmActions

array

任意

監視タスクに関連付けられたスケーリングルールの一意識別子リストです。

string

任意

監視タスクに関連付けられたスケーリングルールの一意識別子リストです。

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

Dimensions

array<object>

任意

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

object

任意

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

DimensionKey

string

任意

メトリックのディメンションキーです。有効値はメトリクスタイプによって異なります。

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

  • MetricType を system に設定した場合、このパラメーターの有効値は以下のとおりです。

    • user_id:ご利用の Alibaba Cloud アカウント ID。

    • scaling_group:監視タスクでモニタリング対象とするスケーリンググループ。

    • device:NIC タイプ。

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

device

DimensionValue

string

任意

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

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

  • MetricType を system に設定した場合、このパラメーターの有効値は以下のとおりです。

    • user_id:システムが値を指定します。

    • scaling_group:システムが値を指定します。

    • device:このパラメーターを eth0 または eth1 に設定できます。

      • クラシックネットワークタイプのインスタンスの場合、eth0 は内部 NIC を指定します。VPC 内の各インスタンスには eth0 NIC が 1 つしか存在しません。

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

    • state:このパラメーターを TCP_TOTAL または ESTABLISHED に設定できます。

      • TCP_TOTAL は TCP 接続総数を指定します。

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

eth0

Expressions

array<object>

任意

マルチメトリックアラートルールに関する情報です。

object

任意

マルチメトリックアラートルールで指定された式です。

MetricName

string

任意

マルチメトリックアラートルール内のメトリック名です。このパラメーターの有効値はメトリクスタイプによって異なります。

  • MetricType を custom に設定した場合、有効値はお客様が保有しているメトリックです。

  • MetricType を system に設定した場合、このパラメーターの有効値は以下のとおりです。

    • CpuUtilization:CPU 使用率。単位:%。

    • ConcurrentConnections:同時接続数。

    • IntranetTx:内部ネットワークのアウトバウンドトラフィック。単位:KB/分。

    • IntranetRx:内部ネットワークのインバウンドトラフィック。単位:KB/分。

    • VpcInternetTx:VPC のアウトバウンドトラフィック。単位:KB/分。

    • VpcInternetRx:VPC のインバウンドトラフィック。単位:KB/分。

    • SystemDiskReadBps:システムディスクから 1 秒間に読み取られるバイト数。

    • SystemDiskWriteBps:システムディスクに 1 秒間に書き込まれるバイト数。

    • SystemDiskReadOps:システムディスクの読み取り IOPS。単位:回/s。

    • SystemDiskWriteOps:システムディスクの書き込み IOPS。単位:回/s。

    • CpuUtilizationAgent:CPU 使用率。単位:%。

    • GpuUtilizationAgent:GPU 使用率。単位:%。

    • GpuMemoryFreeUtilizationAgent:アイドル GPU メモリ使用率。単位:%。

    • GpuMemoryUtilizationAgent:GPU メモリ使用率。単位:%。

    • MemoryUtilization:メモリ使用量。単位:%。

    • LoadAverage:システム平均負荷。

    • TcpConnection:TCP 接続総数。

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

    • PackagesNetOut:内部 NIC から送信されるパケット数。単位:回/s。

    • PackagesNetIn:内部 NIC で受信されるパケット数。単位:回/s。

    • PackagesNetOut:パブリック NIC から送信されるパケット数。単位:回/s。

    • PackagesNetIn:パブリック NIC で受信されるパケット数。単位:回/s。

    • EciPodCpuUtilization:CPU 使用率。単位:%。

    • EciPodMemoryUtilization:メモリ使用量。単位:%。

    • LoadBalancerRealServerAverageQps:インスタンスの秒間クエリ数 (QPS)。

詳細については、「システム監視タイプの監視タスク」をご参照ください。

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 になった場合にのみアラートがトリガーされます。

  • ||:マルチメトリックアラートルール内のいずれか 1 つのメトリックがトリガー条件を満たした場合にアラートがトリガーされます。

デフォルト値:&&

&&

レスポンスフィールド

フィールド

説明

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****"
}

エラーコード

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

変更履歴

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