调用ModifySiteMonitor接口修改站点监控探测任务。

站点监控支持以下8种类型的探测任务,不同类型对应不同的扩展参数(OptionsJson),扩展参数说明如下表所示。

HTTP

参数名

类型

描述

http_method

String

HTTP请求方式。取值:GET、POST、HEAD。默认值:GET。

header

String

换行符(\n)分隔的用户自定义HTTP Header。每行Header格式需符合HTTP协议要求(英文冒号分隔的键值)。

cookie

String

Cookie和HTTP请求标准的写法一致。

request_content

String

请求内容。支持JSON和表单格式。当不提供请求内容时,请求中不含正文。

response_content

String

期望的回应内容。探测时会在HTTP服务器返回的前64个字节进行检查。

match_rule

String

0:表示回应中不含response_content时,探测成功。

1:表示回应中含response_content时,探测成功。

username

String

如果提供用户名,则会在HTTP请求中携带BasicAuth Header。

password

String

HTTP请求验证密码。

time_out

int

超时时间。单位:毫秒。默认值:5秒。

max_redirect

int

大跳转次数。ECS探针默认5次,运营商探针默认2次。如果需要禁止跳转,则将该值设置为:0。取值范围:0~50。

PING

参数名

类型

描述

failure_rate

int

当PING失败率超过该值时。则探测失败,返回610(PingAllFail)或615(PingPartialFail)。默认值:0.1 。

ping_num

int

PING次数。取值范围:1~100。默认值:20。

DNS

参数名

类型

描述

dns_server

string

DNS服务器地址,可以为域名或IP地址。

dns_type

string

DNS查询类型。取值:A、NS、CNAME、MX、TXT、ANY。

expect_value

string

分隔的期望值列表。

match_rule

string

期望值列表与DNS列表的关系。当不满足指定关系时,探测失败。

空字符串或IN_DNS:期望值列表是DNS列表的子集。

DNS_IN:DNS列表是期望值列表的子集。

EQUAL:DNS列表与期望值列表相等。

ANY:DNS列表与期望值列表有交集(交集不为空)。

FTP

参数名

类型

描述

port

int

FTP服务器端口号。如果不提供,则使用默认值。FTP默认值:21,FTPs默认值:990。

username

string

FTP用户名。 如果未提供FTP用户信息,则匿名登录。

password

string

FTP密码。

POP3/SMTP

参数名

类型

描述

port

int

POP3服务器端口号。 POP3默认值:110, POP3s默认值:995。

username

string

用户名。

password

string

密码。

TCP/UDP

参数名

类型

描述

port

int

探测的TCP/UDP端口。

request_content

string

请求内容。当request_format为hex时,request_content的内容为十六进制紧凑格式。

request_format

string

当request_format为其他值时,request_content作为普通字符串发送给服务器。

response_content

string

回应内容。当服务器返回的内容中不含response_content时,探测失败。

当response_format为hex时,response_content中的内容为十六进制紧凑格式。

当response_content为其他值时,response_content为普通字符串。

调试

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

请求参数

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

要执行的操作,取值:ModifySiteMonitor。

TaskId String 49f7b317-7645-4cc9-94fd-ea42e522****

站点监控探测任务ID。

Address String http://www.aliyun.com

任务的探测URL地址或IP地址。

TaskName String 网站探测修改

站点监控探测任务名称。长度4~100个字符串,包括大小写字母、数字、下划线(_)和汉字。

Interval String 1

探测频率。

取值:1、5、15。单位:分钟。默认值:1。

IspCities String [{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]

探针的信息。格式;JSONArray,例如:[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]

city分别对应北京、杭州、青岛。

您可以使用DescribeSiteMonitorISPCityList接口获取探测点信息。如果为空系统,则随机选择3个探点探测。

OptionsJson String {"time_out":5000}

监控对应协议的高级扩展选项, 不同的探测协议类型,有不同的扩展选项。

AlertIds String 49f7c317-7645-4cc9-94fd-ea42e122****

关联已存在的报警规则ID。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Data Struct

修改任务结果详情。

count Integer 1

站点监控探测任务数。

Message String Successfully

返回信息。

RequestId String 68192f5d-0d45-4b98-9724-892813f86c71

请求的ID。

Success String true

操作是否成功。true表示成功,false表示失败。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifySiteMonitor
&TaskId=49f7b317-7645-4cc9-94fd-ea42e522****
&<公共请求参数>

正常返回示例

XML 格式

<ModifySiteMonitor>
	  <Data>
		    <count>1</count>
	  </Data>
	  <Message>Successfully</Message>
	  <RequestId>B6593DD0-73E6-48EF-8019-ED4687ED378D</RequestId>
	  <Success>true</Success>
	  <Code>200</Code>
</ModifySiteMonitor>

JSON 格式

{
  "Data": {
    "count": 1
  },
  "Message": "Successfully",
  "RequestId": "B6593DD0-73E6-48EF-8019-ED4687ED378D",
  "Success": true,
  "Code": "200"
}

错误码

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