调用ModifyHostAvailability接口修改可用性监控任务。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyHostAvailability

要执行的操作，取值：ModifyHostAvailability。
AlertConfig.NotifyType Integer 是 2

报警通知类型。取值：

  • 2：电话+短信+邮件+钉钉机器人。
  • 1：短信+邮件+钉钉机器人。
  • 0：邮件+钉钉机器人。
AlertConfigEscalationList.N.MetricName String 是 HttpStatus

需要报警的监控项。N的取值范围：1~21。取值：

  • HttpStatus：HTTP状态码。
  • HttpLatency：HTTP等待时间。
  • TelnetStatus：TELNET状态码。
  • TelnetLatency：TELNET等待时间。
  • PingLostRate：PING丢包率。
GroupId Long 是 12345

应用分组ID。
Id Long 是 123456

可用性监控任务ID。
TaskName String 是 task1

可用性监控任务名称。
TaskScope String 否 GROUP

可用性监控任务的探测范围。取值：

  • GROUP：表示当前应用分组内的所有ECS实例作为探测任务的探针。
  • GROUP_SPEC_INSTANCE：表示在应用分组内添加的实例作为探测任务的探针。设置该参数时，需要同时设置InstanceList（探测的ECS实例列表）。
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

探测类型的方法。取值：

  • GET
  • POST
  • HEAD
说明 如果探测任务类型为HTTP，则需要设置该参数。探测任务类型的设置方法，请参见CreateHostAvailability。
TaskOption.HttpNegative Boolean 否 true

匹配HTTP响应内容的报警规则。取值：

  • true：如果HTTP响应内容包含设置的报警规则，则报警。
  • false：如果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。不同监控项的统计方法取值如下：

  • HttpStatus：Value。
  • HttpLatency：Average。
  • TelnetStatus：Value。
  • TelnetLatency：Average。
  • PingLostRate：Average。
说明 状态码类的统计方法为原始值（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

操作是否成功。取值：

  • true：成功。
  • false：失败。

示例

请求示例

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
}

错误码

访问错误中心查看更多错误码。