UpdateTimingSyntheticTask - 更新定时拨测任务_应用实时监控服务(ARMS)-阿里云帮助中心

更新定时拨测任务。

接口说明

云拨测目前仅在杭州 region 提供服务，使用 SDK 或 OpenAPI 时请选择杭州 region 对应的服务接入点。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
arms:UpdateTimingSyntheticTask	Write	SyntheticTask acs:arms:{#regionId}:{#accountId}:synthetictask/{#TaskId}	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID。	cn-hangzhou
TaskId	string	否	云拨测任务 ID。	5308a2691f59422c8c3b7aeccxxxxxxx
Name	string	否	任务名称。	拨测任务
MonitorConf	object	否	任务配置。
NetICMP	object	否	ICMP 任务配置。
TargetUrl	string	否	拨测目标地址，只能输入 IP 地址或者域名，不能包括端口号、协议头、请求路径等。	www.aliyun.com
Interval	long	否	发送间隔，ICMP(PING)包发送的时间间隔必须在 200~10000ms 之间。	300
PackageNum	integer	否	发送 ICMP（Ping）数据包的数量。最小值为 1，最大值为 50，默认为 4。	4
PackageSize	integer	否	发送 ICMP（Ping）数据包的大小。单位为 byte，ICMP(PING)包大小只限 32, 64, 128, 256, 512, 1024, 1080, 1450。	32
SplitPackage	boolean	否	是否拆分 ICMP（Ping）数据包。默认为 true。	true
Timeout	long	否	ICMP 拨测的超时时间。单位为毫秒（ms），最小值为 1000，最大值为 300000，默认为 20000。	5000
TracertEnable	boolean	否	是否开启 tracert。默认为 true。	true
TracertNumMax	integer	否	tracert 的最大跃点数。最小值为 1，最大值为 128，默认为 20。	20
TracertTimeout	long	否	tracert 的超时时间。单位为毫秒（ms），最小值为 1000，最大值为 300000，默认为 60000。	60000
NetTCP	object	否	TCP 拨测的配置参数。当 TaskType 为 2 时必填。
TargetUrl	string	否	拨测目标地址（主机）。	127.0.0.1:8888
ConnectTimes	integer	否	建立 TCP 连接的次数。最小值为 1，最大值为 16，默认为 4。	4
Interval	long	否	建立 TCP 连接的时间间隔。单位为毫秒（ms），最小值为 200，最大值为 10000，默认为 200。	300
Timeout	long	否	TCP 拨测超时时间。单位为毫秒（ms），最小值为 1000，最大值为 300000，默认为 20000。	1000
TracertEnable	boolean	否	是否开启 tracert。默认为 true。	true
TracertNumMax	integer	否	tracert 的最大跃点数。最小值为 1，最大值为 128，默认为 20。	20
TracertTimeout	long	否	tracert 的超时时间。单位为毫秒（ms），最小值为 1000，最大值为 300000，默认为 60000。	1000
NetDNS	object	否	DNS 任务配置参数。
TargetUrl	string	否	域名。	www.aliyun.com
Dig	integer	否	是否以 dig 形式展示数据内容, 0-否，1-是。	0
DnsServerIpType	integer	否	DNS 服务器 IP 类型。0：ipv4，1：ipv6，2: 自动，默认为 0。	0
NsServer	string	否	NS 服务器 IP，默认 114.114.114.114。	114.114.114.114
QueryMethod	integer	否	DNS 查询方式，0-递归，1-迭代，默认为 0。	0
Timeout	long	否	DNS 拨测超时时间。单位为毫秒（ms），最小值为 1000，最大值为 45000，默认为 5000。	1000
ApiHTTP	object	否	HTTP(s)类型任务配置。
TargetUrl	string	否	拨测目标地址（请求路径）。	https://********
Method	string	否	请求方法。 POST GET	POST
RequestHeaders	object	否	指定的自定义请求头部字段。
	string	否	HTTP 请求头。	{ "key1": "value1", "key2": "value2" }
RequestBody	object	否	HTTP 请求体
Content	string	否	请求体内容，为 JSON 字符串格式。当 type 为 text/plain，application/json，application/xml，text/html，content 内容转为 JSON 字符串即可。	{ "key1": "value1", "key2": "value2" }
Type	string	否	请求体类型，支持：text/plain、application/json、application/x-www-form-urlencoded、multipart/form-data、application/xml、text/html	application/json
ConnectTimeout	long	否	连接超时，单位 ms，默认 5000，可选范围 1000~300000。	5000
Timeout	long	否	超时时间，单位 ms，默认 10000，可选范围 1000~300000。	5000
CheckCert	boolean	否	是否校验证书，默认为否。	true
Website	object	否	网站测速类型任务配置。
TargetUrl	string	否	网址。	https://********
AutomaticScrolling	integer	否	是否支持自动滚动屏幕，加载页面。0-否，1-是，默认为 0。	0
CustomHeader	integer	否	自定义 header。0：关（默认），1：修改第一包，2：修改全部包。	0
CustomHeaderContent	object	否	自定义 header，JSON Map 格式。
	string	否	自定义 header，JSON Map 格式。	{ "key1": "value1", "key2": "value2" }
DisableCache	integer	否	是否禁用缓存，0-不禁用，1-禁用，默认为 1。	0
DisableCompression	integer	否	通过 Accept-Encoding 字段判断是否接受压缩文件，0-不禁用，1-禁用，默认为 0。	0
FilterInvalidIP	integer	否	是否过滤非有效 IP。 1：不过滤 0：过滤	0
IgnoreCertificateError	integer	否	是否忽略在 SSL 握手中证书校验过程中的证书错误而继续浏览，0-不忽略，1-忽略，默认为 1。	0
MonitorTimeout	long	否	监测超时，单位为 ms，默认 40000，可选范围为 5000~300000ms。	20000
Redirection	integer	否	当出现重定向后，是否要继续浏览, 0-否，1-是，默认是 1。	0
SlowElementThreshold	long	否	慢元素阈值，单位为 ms，默认 5000，可选范围为 1~300000ms。	5000
WaitCompletionTime	long	否	最大等待完成时间，单位为 ms，默认 5000，可选范围为：5000~300000ms。	5000
VerifyStringBlacklist	string	否	验证字符串即监测页面源代码中的某个任意字符串。若客户端返回的源码中包含任一黑名单中的字符串则报 650 验证字符串失败的错误。多个字符串以竖线（\|）隔开。	error
VerifyStringWhitelist	string	否	验证字符串即监测页面源代码中的某个任意字符串。客户端返回的源码必须包含所有白名单中的字符串，否则报 650 验证字符串失败的错误。多个字符串以竖线（\|）隔开。	success
ElementBlacklist	string	否	在页面加载过程中如果出现元素黑名单中配置的元素，不会请求加载该元素。	a.jpg
DNSHijackWhitelist	string	否	域名（例如 www.aliyun.com）解析时，解析出的 IP 地址或者 CNAME 不在 DNS 劫持白名单内，用户就会访问失败或者返回一个非 Aliyun 的目标 IP；若解析结果中的 IP 或者 CNAME 在 DNS 白名单内，则会被认定为没有发生 DNS 劫持。填写格式：域名:匹配规则。匹配规则支持 IP、IP 通配符、子网掩码和 CNAME，可以填写多个匹配规则，多个匹配规则以竖线（\|）隔开。例如：www.aliyun.com:203.0.3.55\|203.3.44.67，表示 www.aliyun.com 域名下除 203.0.3.55 和 203.3.44.67 之外的其他 IP 都是被劫持的。	www.aliyun.com:203.0.3.55\|203.3.44.67
PageTamper	string	否	监测页面出现了域名设置之外的元素都属于页面被篡改。常见的表现形式为弹出广告、浮动广告、跳转等。	www.aliyun.com:\|/cc/bb/a.gif\|/vv/bb/cc.jpg
FlowHijackJumpTimes	integer	否	识别元素：设置浏览页面元素总个数。	1
FlowHijackLogo	string	否	劫持标识：设置匹配的关键信息。填写劫持判断关键字或关键元素，允许带星号（*）。	aliyun
FileDownload	object	否	文件下载类型任务配置。
TargetUrl	string	否	文件下载链接。	https://img.alicdn.com/tfs/TB13DzOjXP7gK0jSZFjXXc5aXXa-212-48.png
DownloadKernel	integer	否	下载内核。 1：curl 0：WinInet	0
QuickProtocol	integer	否	Quick 协议 1：http1 2：http2 3：http3	1
ConnectionTimeout	long	否	连接超时时间，ms，默认 5000，可选范围：1000~120000ms 之间。	5000
MonitorTimeout	long	否	监测超时时间，ms，默认 60000，可选范围：1000~120000ms 之间。	60000
CustomHeaderContent	object	否	自定义请求头内容，JSON Map。
	string	否	自定义请求头内容，JSON Map。	{ "key1": "value1", "key2": "value2" }
IgnoreCertificateStatusError	integer	否	证书状态错误忽略，0:不忽略，1:忽略，默认 1。	0
IgnoreCertificateUntrustworthyError	integer	否	证书不可信忽略，0:不忽略，1:忽略，默认 1。	0
IgnoreInvalidHostError	integer	否	主机无效错误忽略，0:不忽略，1:忽略，默认 1。	0
Redirection	integer	否	是否支持重定向, 0:不支持，1:支持，默认 1。	0
TransmissionSize	long	否	传输大小，KB，默认 2048KB，文件下载的传输大小必须在 1~20480KB 之间。	2048
IgnoreCertificateCanceledError	integer	否	忽略证书撤销错误 0:不忽略，1:忽略，默认 1。	0
IgnoreCertificateAuthError	integer	否	忽略 CA 证书授权错误 0:不忽略，1:忽略，默认 1。	0
IgnoreCertificateOutOfDateError	integer	否	忽略证书过期错误 0:不忽略，1:忽略，默认 1。	0
IgnoreCertificateUsingError	integer	否	忽略证书使用错误 0:不忽略，1:忽略，默认 1。	0
VerifyWay	integer	否	验证方式。 0：不验证 1：验证字符串 2：MD5 验证	0
ValidateKeywords	string	否	验证关键词。	aliyun
WhiteList	string	否	DNS 劫持白名单。匹配规则支持 IP、IP 通配符、子网掩码和 CNAME，可以填写多个匹配规则，多个匹配规则以竖线（\|）隔开。例如：www.aliyun.com:203.0.3.55\|203.3.44.67，表示 www.aliyun.com 域名下除 203.0.3.55 和 203.3.44.67 之外的其他 IP 都是被劫持的。	www.aliyun.com:203.0.3.55\|203.3.44.67
Stream	object	否	流媒体拨测配置。
TargetUrl	string	否	流媒体地址。	http://www.aliyun.com/stream/test.mp4
StreamType	integer	否	音视频标志：0-视频，1-音频。	0
StreamMonitorTimeout	integer	否	监测时长，单位秒，最长支持 60s，不传默认 60。	30
StreamAddressType	integer	否	资源地址类型： 1：资源地址。 0：页面地址。不传默认 0。	1
PlayerType	integer	否	播放器，不传默认 12。 12：VLC 2：FlashPlayer	2
CustomHeaderContent	object	否	自定义 header，JSON Map 格式。
	string	否	自定义 header，JSON Map 格式。	{ "key1": "value1", "key2": "value2" }
WhiteList	string	否	DNS 劫持白名单。匹配规则支持 IP、IP 通配符、子网掩码和 CNAME，可以填写多个匹配规则，多个匹配规则以竖线（\|）隔开。例如：www.aliyun.com:203.0.3.55\|203.3.44.67，表示 www.aliyun.com 域名下除 203.0.3.55 和 203.3.44.67 之外的其他 IP 都是被劫持的。	www.aliyun.com:203.0.3.55\|203.3.44.67
Monitors	object []	否	监测点列表。
CityCode	string	否	城市编码。	100001
OperatorCode	string	否	运营商编码。	1
ClientType	integer	否	拨测点客户端类型： 1：IDC 2：网民 3：移动端 4：云主机	4
Frequency	string	否	拨测频率，可选范围：1m,5m,10m,15m,20m,30m,1h,2h,3h,4h,6h,8h,12h,24h。	5m
CustomPeriod	object	否	自定义周期。
EndHour	integer	否	当天结束拨测时间的小时数。	22
StartHour	integer	否	当天开始拨测时间的小时数。	14
CommonSetting	object	否	通用设置。
CustomHost	object	否	自定义 host。
Hosts	object []	否	host 列表。
Domain	string	否	域名。	www.aliyun.com
IpType	integer	否	IP 类型： 0：自动 1：IPv4 2：IPpv6	0
Ips	array	否	IP 列表。
	string	否	IP 地址。	127.0.0.1
SelectType	integer	否	选择方式： 0：随机 1：轮询	0
IpType	integer	否	IP 类型： 0：自动 1：IPv4 2：IPpv6	0
MonitorSamples	integer	否	是否均匀分配监测样本： 0：否 1：是	0
IsOpenTrace	boolean	否	是否开启链路追踪。	true
TraceClientType	integer	否	链路追踪客户端类型： 0：ARMS Agent 1：OpenTelemetry 2：Jaeger	1
XtraceRegion	string	否	链路数据上报 region。	cn-hangzhou
CustomVPCSetting	object	否	用户 VPC 信息，如果拨测的是阿里云内网地址，需要配置 VPC 信息。
RegionId	string	否	地域 ID。	cn-hangzhou
VpcId	string	否	VPC ID.	vpc-bp15bjtubjytclwxxxxxx
VSwitchId	string	否	交换机 ID。	vsw-2zevek6r3mpny7wxxxxxv
SecureGroupId	string	否	安全组 ID，此安全组是拨测客户端所在的安全组，安全组限定了拨测客户端在 VPC 中的出入站规则。需要设置您的 VPC 所在安全组的入站规则为允许拨测客户端所在的安全组访问。否则，拨测客户端无法顺畅地访问您的 VPC 内资源。	sg-xxxxxxxx
AvailableAssertions	object []	否	断言列表
Type	string	否	断言类型，包括：HttpResCode、HttpResHead、HttpResBody、HttpResBodyJson、HttpResponseTime、IcmpPackLoss（丢包率）、IcmpPackMaxLatency（最大包延时 ms）、IcmpPackAvgLatency（平均延时）、TraceRouteHops（跃点数目）、DnsARecord（A 记录）、DnsCName（Cname）、websiteTTFB（首包时间）、websiteTTLB（尾包时间）、websiteFST（首屏时间）、websiteFFST（首屏完全渲染时间）、websiteOnload（完全加载时间），具体使用见下文补充说明。	TraceRouteHops
Target	string	否	检查目标，当为 HttpResCode 与 HttpResBody、HttpResponseTime 时，target 不需要填，当为 HttpResHead 时，需指定 header 中的 key，当为 HttpResBodyJson 时，使用 jsonPath。	HttpResponseTime
Operator	string	否	条件：gt：大于；gte：大于等于；lt：小于；te：小于或等于；eq：等于；neq：不等于；ctn：包含；nctn：不包含；exist：存在；n_exist：不存在；belong：属于；n_belong：不属于；reg_match：正则匹配。	eq
Expect	string	否	期望值。	200
ResourceGroupId	string	否	资源组 ID。	rg-acfmxyexli2****
Tags	object []	否	标签列表。
Key	string	否	标签的键(key)。	key
Value	string	否	标签的值(value)。	value

断言配置说明如下：

HTTP 类型任务

type 为 HttpResCode 时，operator 支持 eq、neq、gt、gte、lt、lte、belong、n_belong
type 为 HttpResHead 时，operator 支持所有
type 为 HttpResBody，operator 支持所有
type 为 HttpResBodyJson，operator 支持所有
type 为 HttpResponseTime，支持 gt、gte、lt、lte、eq、belong

ICMP 类型任务

type 为 IcmpPackLoss 时，名称为丢包率%，支持 gt、gte、lt、lte、eq、belong
type 为 IcmpPackMaxLatency 时，名称为最大包延时 ms，支持 gt、gte、lt、lte、eq、belong
type 为 IcmpPackAvgLatency 时，名称为平均延时 ms，支持 gt、gte、lt、lte、eq、belong
TraceRouteHops 时，名称为跃点数目，支持 gt、gte、lt、lte、eq、belong

DNS 类型任务

type 为 DnsARecord 时，名称为 A 记录，target 有两个选择 every（展示-每条记录）和 any（展示-存在记录），支持 eq、ctn、nctn、reg_match、not_reg_match
type 为 DnsCName 时，名称为 Cname，target 有两个选择 every（展示-每条记录）和 any（展示-存在记录），支持 eq、ctn、nctn、reg_match、not_reg_match

WEBSITE 类型任务

type 为 websiteTTFB 时，名称为首包时间，支持 gt、gte、lt、lte、eq、belong
type 为 websiteTTLB 时，名称为尾包时间，支持 gt、gte、lt、lte、eq、belong
type 为 websiteFST 时，名称为首屏时间，支持 gt、gte、lt、lte、eq、belong
type 为 websiteFFST 时，名称为首屏完全渲染时间，支持 gt、gte、lt、lte、eq、belong
type 为 websiteOnload 时，名称为完全加载时间，支持 gt、gte、lt、lte、eq、belong

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	F7781D4A-2818-41E7-B7BB-79D809E9****
Success	boolean	操作是否成功： `true`：操作成功 `false`：操作失败	true
Code	long	状态码。200 为成功，其他状态码为异常。	200
Message	string	返回信息。	success
Data	object	返回结果。
TaskId	string	任务 ID。	1eeb351722c84e05b52c82fd0dc9953e

示例

正常返回示例

JSON格式

{
  "RequestId": "F7781D4A-2818-41E7-B7BB-79D809E9****",
  "Success": true,
  "Code": 200,
  "Message": "success",
  "Data": {
    "TaskId": "1eeb351722c84e05b52c82fd0dc9953e"
  }
}

错误码

HTTP status code	错误码	错误信息
400	ParameterMissing	%s
400	ParameterIllegal	%s
400	TaskQuotaLimit	%s
400	ParameterRegionIllegal	%s
400	DuplicateTagKey	Param tagKey is duplicate.
400	TagNumOUT	the number of tag is out .
400	NoPermissionUSER	user no permission
403	RAMNotAuthorize	%s
403	STSNotAuthorize	%s
403	IllegalUserAccess	%s
403	APINotAuthorize	%s
403	CommercialStatusException	%s
403	SyntheticTrailExpired	%s
403	SyntheticInDebt	%s
403	SyntheticDailyTimesExhausted	%s
403	SyntheticDailyLimit	%s
403	INNER_PROHIBIT	内部用户禁用云拨测服务, 如需使用, 请加钉钉群31359689联系白玙

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

变更历史

变更时间

变更内容概要

操作

2024-04-12

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403

2024-03-14

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403

2024-03-01

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403

2024-02-23

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403

2024-01-05

OpenAPI 错误码发生变更、OpenAPI 入参发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403
入参	OpenAPI 入参发生变更。
	删除入参：TaskType
	删除入参：MonitorCategory

2023-11-07

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	删除错误码：400
	删除错误码：403

2023-10-26

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	错误码 403 变更
	删除错误码：400

2023-09-08

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	错误码 403 变更
	删除错误码：400