调用ModifyAlarm修改一个报警任务。
接口说明
报警任务支持的系统监控项的数据由云监控采集,您需要配合维度信息确定监控数据的聚合范围。例如,指定user_id和 scaling_group即确定聚合该用户、该伸缩组下所有ECS实例的监控项数据。
监控项和维度信息的配合关系如下:
监控项 |
描述 |
维度信息 |
---|---|---|
CpuUtilization |
CPU使用率(%) |
user_id、scaling_group |
ClassicInternetRx |
经典网络外网入流量(KB/min) |
user_id、scaling_group |
ClassicInternetTx |
经典网络外网出流量(KB/min) |
user_id、scaling_group |
VpcInternetRx |
VPC网络外网入流量(KB/min) |
user_id、scaling_group |
VpcInternetTx |
VPC网络外网出流量(KB/min) |
user_id、scaling_group |
IntranetRx |
内网入流量(KB/min) |
user_id、scaling_group |
IntranetTx |
内网出流量(KB/min) |
user_id、scaling_group |
LoadAverage |
系统平均负载 |
user_id、scaling_group |
MemoryUtilization |
内存使用率(%) |
user_id、scaling_group |
SystemDiskReadBps |
系统盘读BPS(Byte/s) |
user_id、scaling_group |
SystemDiskWriteBps |
系统盘写BPS(Byte/s) |
user_id、scaling_group |
SystemDiskReadOps |
系统盘读IOPS(次/s) |
user_id、scaling_group |
SystemDiskWriteOps |
系统盘写IOPS(次/s) |
user_id、scaling_group |
PackagesNetIn |
网卡收包数(个/s) |
user_id、scaling_group、device |
PackagesNetOut |
网卡发包数(个/s) |
user_id、scaling_group、device |
TcpConnection |
TCP连接数(个) |
user_id、scaling_group、state |
其中,user_id和scaling_group由系统自动填充,device、state需要您手动指定。更多说明请参见参数Dimension.N.DimensionKey和Dimension.N.DimensionValue。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyAlarm |
系统规定参数。取值:ModifyAlarm |
AlarmTaskId | String | 是 | asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1**** |
报警任务的ID。 |
RegionId | String | 是 | cn-qingdao |
报警任务所属地域的ID。 |
Name | String | 否 | alarmtask**** |
报警任务的名称。 |
Description | String | 否 | Test alarm task. |
报警任务的描述。 |
AlarmAction.N | RepeatList | 否 | ari:acs:ess:cn-hangzhou:140692647****:scalingrule/asr-bp163l21e07uhn**** |
报警任务关联伸缩规则的唯一标识符。 |
MetricName | String | 否 | MemoryUtilization |
监控项名称。取值范围:
更多信息请参见接口说明。 |
MetricType | String | 否 | system |
监控项类型。取值范围:
|
Period | Integer | 否 | 300 |
统计监控项数据的周期,单位为秒。取值范围:
|
Statistics | String | 否 | Average |
统计监控项数据的方法。取值范围:
|
Threshold | Float | 否 | 80 |
监控指标的阈值,满足阈值表达式达到指定次数即触发执行伸缩规则。 |
ComparisonOperator | String | 否 | >= |
监控项统计值与阈值的比较符,用于指定监控项统计值与阈值在什么关系下满足条件。取值范围:
|
EvaluationCount | Integer | 否 | 3 |
触发执行伸缩规则需要满足阈值表达式的次数,例如,CPU使用率平均值3次的统计结果均大于等于80%。 |
GroupId | Integer | 否 | 4055401 |
自定义监控项所属云监控应用分组的ID,仅在监控项类型为custom时需要指定该参数。 |
Dimension.N.DimensionKey | String | 否 | device |
监控项关联的维度信息键。取值范围:
|
Dimension.N.DimensionValue | String | 否 | eth0 |
监控项关联的维度信息值,取值范围由维度信息键决定。 user_id:由系统自动填充。 scaling_group:由系统自动填充。 device取值范围:
state取值范围:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AlarmTaskId | String | asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778**** |
报警任务ID。 |
RequestId | String | BACACF83-7070-4953-A8FD-D81F89F1**** |
请求ID。 |
示例
请求示例
https://ess.aliyuncs.com/?Action=ModifyAlarm
&RegionId=cn-qingdao
&AlarmTaskId=asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****
&MetricName=MemoryUtilization
&<公共请求参数>
正常返回示例
XML
格式
<ModifyAlarmResponse>
<AlarmTaskId>asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****</AlarmTaskId>
<RequestId>BACACF83-7070-4953-A8FD-D81F89F1****</RequestId>
</ModifyAlarmResponse>
JSON
格式
{
"AlarmTaskId": "asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****",
"RequestId": "BACACF83-7070-4953-A8FD-D81F89F1****"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交