ModifyAlarm - Auto Scaling

修改一個警報任務。

介面說明

如果您建立自訂監控類型的警報任務（MetricType=custom），您需要先將自訂監控項目指標上報到雲端監控。具體操作，請參見自訂監控警報任務。
建立警報任務時，您需要指定監控項目（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.DimensionKey和Dimension.N.DimensionValue。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

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）時，取值範圍如下： CpuUtilization：（ECS）CPU 使用率（%）。 IntranetTx：（ECS）內網出流量（Kb/min）。 IntranetRx：（ECS）內網入流量（Kb/min）。 VpcInternetTx：（ECS）外網出流量（Kb/min）。 VpcInternetRx：（ECS）外網入流量（Kb/min）。 SystemDiskReadBps：（ECS）系統磁碟讀 BPS（位元組/s）。 SystemDiskWriteBps：（ECS）系統磁碟寫 BPS（位元組/s）。 SystemDiskReadOps：（ECS）系統磁碟讀 IOPS（次/s）。 SystemDiskWriteOps：（ECS）系統磁碟寫 IOPS（次/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）網卡傳送封包數（個/s）。 PackagesNetIn：（Agent）網卡接收封包數（個/s）。 PackagesNetOut：（Agent）外網網卡傳送封包數（個/s）。 PackagesNetIn：（Agent）外網網卡接收封包數（個/s）。 EciPodCpuUtilization：CPU 使用率（%）。 EciPodMemoryUtilization：記憶體（%）。 LoadBalancerRealServerAverageQps：（ALB）伺服器群組單機 QPS（次/s）。更多資訊，請參見系統監控警報任務。	MemoryUtilization
MetricType	string	否	監控項目類型。取值範圍： system：使用雲端監控系統指標。 custom：使用上報到雲端監控的自訂指標。	system
Period	integer	否	統計監控項目資料的週期，單位：秒。取值範圍： 15。 60。 120。 300。 900。說明僅 ECS 類型的伸縮群組支援設定 15 秒的統計週期。	300
Statistics	string	否	統計監控項目資料的方法。取值範圍： Average：平均值。 Minimum：最小值。 Maximum：最大值。	Average
Threshold	number	否	監控指標的閾值，滿足閾值運算式達到指定次數即觸發執行伸縮規則。	80
ComparisonOperator	string	否	監控項目統計值與閾值的比較符號，用於指定監控項目統計值與閾值在什麼關係下滿足條件。取值範圍：監控項目統計值大於等於閾值。取值：`>=`。監控項目統計值小於等於閾值。取值：`<=`。監控項目統計值大於閾值。取值：`>`。監控項目統計值小於閾值。取值：`<`。	>=
EvaluationCount	integer	否	觸發執行伸縮規則需要滿足閾值運算式的次數。例如，CPU 使用率平均值 3 次的統計結果均大於等於 80%。	3
GroupId	integer	否	自訂監控項目所屬雲端監控應用程式群組的 ID，僅在監控項目類型為 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**:scalingrule/asr-bp163l21e07uhn**
	string	否	警報任務關聯伸縮規則的唯一識別碼。	ari:acs:ess:cn-hangzhou:140692647**:scalingrule/asr-bp163l21e07uhn**
Dimension	array<object>	否	監控項目關聯的維度資訊。
	object	否	監控項目關聯的維度資訊。
DimensionKey	string	否	監控項目關聯的維度資訊鍵。取值範圍與警報任務的監控類型有關：當警報任務為自訂監控類型（即 MetricType=custom）時，不限制取值範圍，由您自行指定。當警報任務為系統監控類型（即 MetricType=system）時，取值範圍如下： user_id：您的帳號 ID。 scaling_group：被監控的伸縮群組。 device：網卡裝置的類型。 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 表示內網網卡。對於 VPC 執行個體，只存在 eth0 一張網卡。 eth1：對於經典網路執行個體，eth1 代表外網網卡。 state： TCP_TOTAL：表示總的 TCP 連線數。 ESTABLISHED：表示已建立的 TCP 連線數。	eth0
Expression	array<object>	否	多指標警報規則相關資訊。
	object	否	多指標警報規則相關資訊。
MetricName	string	否	多指標警報規則的監控指標名稱。取值範圍與警報任務的監控類型有關：當警報任務為自訂監控類型（即 MetricType=custom）時，取值範圍是您自有的監控項目範圍。當警報任務為系統監控類型（即 MetricType=system）時，取值範圍如下所示： CpuUtilization：（ECS）CPU 使用率（%）。 IntranetTx：（ECS）內網出流量（Kb/min）。 IntranetRx：（ECS）內網入流量（Kb/min）。 VpcInternetTx：（ECS）外網出流量（Kb/min）。 VpcInternetRx：（ECS）外網入流量（Kb/min）。 SystemDiskReadBps：（ECS）系統磁碟讀 BPS（位元組/s）。 SystemDiskWriteBps：（ECS）系統磁碟寫 BPS（位元組/s）。 SystemDiskReadOps：（ECS）系統磁碟讀 IOPS（次/s）。 SystemDiskWriteOps：（ECS）系統磁碟寫 IOPS（次/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）網卡傳送封包數（個/s）。 PackagesNetIn：（Agent）網卡接收封包數（個/s）。 PackagesNetOut：（Agent）外網網卡傳送封包數（個/s）。 PackagesNetIn：（Agent）外網網卡接收封包數（個/s）。 EciPodCpuUtilization：CPU 使用率（%）。 EciPodMemoryUtilization：記憶體（%）。 LoadBalancerRealServerAverageQps：（ALB）伺服器群組單機 QPS（次/s）。更多資訊，請參見系統監控警報任務。	CpuUtilization
ComparisonOperator	string	否	多指標警報規則的監控項目統計值與閾值的比較符號，用於指定監控項目統計值與閾值在什麼關係下滿足條件。取值範圍：監控項目統計值大於等於閾值。取值：`>=`。監控項目統計值小於等於閾值。取值：`<=`。監控項目統計值大於閾值。取值：`>`。監控項目統計值小於閾值。取值：`<`。預設值：`>=`。	>=
Period	integer	否	多指標警報規則中統計監控項目資料的週期，單位：秒。取值範圍： 15。 60。 120。 300。 900。說明僅 ECS 類型的伸縮群組支援設定 15 秒的統計週期。預設值：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****

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。