调用ModifyHostAvailability接口修改可用性监控任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyHostAvailability |
要执行的操作,取值:ModifyHostAvailability。 |
AlertConfig.NotifyType | Integer | 是 | 2 |
报警通知类型。取值:
|
AlertConfigEscalationList.N.MetricName | String | 是 | HttpStatus |
需要报警的监控项。N的取值范围:1~21。取值:
|
GroupId | Long | 是 | 12345 |
应用分组ID。 |
Id | Long | 是 | 123456 |
可用性监控任务ID。 |
TaskName | String | 是 | task1 |
可用性监控任务名称。 |
TaskScope | String | 否 | GROUP |
可用性监控任务的探测范围。取值:
|
TaskOption.HttpURI | String | 否 | https://www.aliyun.com |
HTTP探测类型的探测URI地址。 |
TaskOption.TelnetOrPingHost | String | 否 | www.aliyun.com |
探测的域名或地址。 说明 如果探测任务类型为PING或TELNET,则需要设置该参数。探测任务类型的设置方法,请参见CreateHostAvailability。
|
TaskOption.HttpResponseCharset | String | 否 | UTF-8 |
HTTP探测类型的响应字符集。 |
TaskOption.HttpPostContent | String | 否 | params1=value1 |
HTTP探测类型探测请求的Post内容。 |
TaskOption.HttpResponseMatchContent | String | 否 | ok |
HTTP探测类型探测请求响应的Post内容。 |
TaskOption.HttpMethod | String | 否 | GET |
探测类型的方法。取值:
说明 如果探测任务类型为HTTP,则需要设置该参数。探测任务类型的设置方法,请参见CreateHostAvailability。
|
TaskOption.HttpNegative | Boolean | 否 | true |
匹配HTTP响应内容的报警规则。取值:
说明 如果探测任务类型为HTTP,则需要设置该参数。探测任务类型的设置方法,请参见CreateHostAvailability。
|
AlertConfig.StartTime | Integer | 否 | 0 |
报警生效的起始时间。取值范围:0~23。 说明 如果报警不在生效时间内,则超过阈值也不会发送报警通知。
|
AlertConfig.EndTime | Integer | 否 | 23 |
报警生效的结束时间。取值范围:0~23。 说明 如果报警不在生效时间内,则超过阈值也不会发送报警通知。
|
AlertConfig.SilenceTime | Integer | 否 | 86400 |
通道沉默时间。单位:秒,默认值:86400(1天)。 |
AlertConfig.WebHook | String | 否 | https://www.aliyun.com/webhook.json |
URL回调地址。 |
AlertConfigEscalationList.N.Aggregate | String | 否 | Value |
报警统计方法。N的取值范围:1~21。不同监控项的统计方法取值如下:
说明 状态码类的统计方法为原始值(Value),延时时间或丢包率的统计方法为平均值(Average)。
|
AlertConfigEscalationList.N.Times | Integer | 否 | 3 |
报警重试次数。N的取值范围:1~21。 |
AlertConfigEscalationList.N.Operator | String | 否 | > |
报警规则比较符号。N的取值范围:1~21。取值:
|
AlertConfigEscalationList.N.Value | String | 否 | 3 |
报警阈值。N的取值范围:1~21。 |
InstanceList.N | RepeatList | 否 | i-absdfkwl321**** |
发起探测的ECS实例列表。N的取值范围:1~21。 说明 该参数为空,表示探测该应用分组下的所有实例。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | ACBDBB40-DFB6-4F4C-8957-51FFB233969C |
请求ID。 |
Message | String | The Request is not authorization. |
错误信息。 |
Code | String | 200 |
状态码。 说明 200表示成功。
|
Success | Boolean | true |
操作是否成功。取值:
|
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyHostAvailability
&AlertConfig.1otifyType=2
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=12345
&Id=123456
&TaskName=task1
&<公共请求参数>
正常返回示例
XML
格式
<ModifyHostAvailabilityResponse>
<RequestId>ACBDBB40-DFB6-4F4C-8957-51FFB233969C</RequestId>
<Success>true</Success>
<Code>200</Code>
</ModifyHostAvailabilityResponse>
JSON
格式
{
"RequestId": "ACBDBB40-DFB6-4F4C-8957-51FFB233969C",
"Success": true,
"Code": 200
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交