イベントトリガータスクを変更します。
操作説明
カスタム監視タイプ (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 パラメーターを参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:ModifyAlarm |
update |
*ScalingGroup。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
イベントトリガータスクのリージョン ID。 |
cn-qingdao |
| AlarmTaskId |
string |
必須 |
イベントトリガータスクの ID。 |
asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1**** |
| Name |
string |
任意 |
イベントトリガータスクの名前。 |
アラームタスク**** |
| Description |
string |
任意 |
イベントトリガータスクの説明。 |
テストアラームタスク |
| MetricName |
string |
任意 |
メトリックの名前。有効な値は、イベントトリガータスクのモニタリングタイプによって異なります。
詳細については、「システムモニタリングのイベントトリガータスク」を参照してください。 |
MemoryUtilization |
| MetricType |
string |
任意 |
メトリックのタイプ。有効な値:
|
system |
| Period |
integer |
任意 |
メトリックデータの統計期間 (秒単位)。有効な値:
説明
15 秒の統計期間は、ECS タイプのスケーリンググループをモニタリングするときに CloudMonitor エージェントによって収集されたメトリック (Agent で始まるメトリック) にのみ適用されます。他のすべてのメトリックでは、統計期間を 60、120、300、または 900 秒に設定できます。 |
300 |
| Statistics |
string |
任意 |
メトリックデータの集約に使用されるメソッド。有効な値:
|
Average |
| Threshold |
number |
任意 |
複数メトリックイベントトリガータスクにおけるモニタリングメトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールが実行されます。 |
80 |
| ComparisonOperator |
string |
任意 |
メトリックの統計値としきい値の間の比較演算子。比較演算子は、統計値としきい値が条件を満たすことができる関係を示します。有効な値:
|
>= |
| EvaluationCount |
integer |
任意 |
スケーリングルールがトリガーされる前に、しきい値の式が満たされる必要がある回数。たとえば、3 回の連続する統計結果において、平均 CPU 使用率が 80% 以上である必要があります。 |
3 |
| GroupId |
integer |
任意 |
カスタムメトリックが属する CloudMonitor アプリケーショングループの ID。このパラメーターは、MetricType が custom に設定されている場合にのみ必須です。 |
4055401 |
| Effective |
string |
任意 |
イベントトリガータスクの有効期間を指定します。 このパラメーターは cron 式に従います。デフォルトのフォーマットは
説明
このパラメーターの値は、デフォルトで協定世界時 (UTC)+8 タイムゾーンです。cron 式の前にタイムゾーン情報 例と説明:
|
TZ=+00 * * 1-2 * * ? |
| AlarmActions |
array |
任意 |
イベントトリガータスクに関連付けられているスケーリングルールの一意の識別子のリスト。 |
|
|
string |
任意 |
イベントトリガータスクに関連付けられているスケーリングルールの一意の識別子のリスト。 |
ari:acs:ess:cn-hangzhou:140692647****:スケーリングルール/asr-bp163l21e07uhn**** |
|
| Dimensions |
array<object> |
任意 |
メトリックに関連付けられているディメンション情報。 |
|
|
object |
任意 |
メトリックに関連付けられているディメンション情報。 |
||
| DimensionKey |
string |
任意 |
メトリックに関連付けられているディメンション情報のキー。有効な値は、イベントトリガーノードのモニタリングタイプによって異なります。
|
デバイス |
| DimensionValue |
string |
任意 |
メトリックに関連付けられているディメンション情報の値。有効な値は Dimension.N.DimensionKey によって決まります。
|
eth0 |
| Expressions |
array<object> |
任意 |
複数メトリックイベントトリガータスクのモニタリングメトリクス。 |
|
|
object |
任意 |
複数メトリックイベントトリガータスクのモニタリングメトリクス。 |
||
| ComparisonOperator |
string |
任意 |
メトリックの統計値としきい値の間の比較演算子。比較演算子は、統計値としきい値が条件を満たすことができる関係を示します。有効な値:
デフォルト値: >=。 |
>= |
| MetricName |
string |
任意 |
複数メトリックイベントトリガーノードにおけるモニタリングメトリクスの名前。有効な値は、イベントトリガータスクのモニタリングタイプによって異なります。
詳細については、「システムモニタリングのイベントトリガータスク」を参照してください。 |
CpuUtilization |
| Period |
integer |
任意 |
複数メトリックイベントトリガータスクにおけるメトリックデータの統計期間 (秒単位)。有効な値:
説明
15 秒の統計期間は、ECS タイプのスケーリンググループをモニタリングするときに CloudMonitor エージェントによって収集されたメトリック (Agent で始まるメトリック) にのみ適用されます。他のすべてのメトリックでは、統計期間を 60、120、300、または 900 秒に設定できます。 デフォルト値: 300。 |
300 |
| Statistics |
string |
任意 |
複数メトリックイベントトリガータスクにおけるメトリックデータの集約に使用されるメソッド。有効な値:
|
Average |
| Threshold |
number |
任意 |
複数メトリックイベントトリガータスクにおけるモニタリングメトリクスのしきい値。しきい値の式が指定された回数満たされると、スケーリングルールが実行されます。 |
40.0 |
| ExpressionsLogicOperator |
string |
任意 |
複数のモニタリングメトリクス条件間の関係。有効な値:
デフォルト値: |
&& |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
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****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。