更新定时拨测任务。
接口说明
云拨测目前仅在杭州 region 提供服务,使用 SDK 或 OpenAPI 时请选择杭州 region 对应的服务接入点。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
arms:UpdateTimingSyntheticTask | create |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 拨测的配置参数。 | |
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 |
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 |
ProtocolAlpnProtocol | integer | 否 | ALPN 协议版本(wap 移动端并且是 HTTPS 任务时可配置): 0-default 系统默认行为 1-http/1.1 2-h2 3-off 关闭,不启用 alpn_protocol | 0 |
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。
| 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 | 否 | 下载内核。
| 0 |
QuickProtocol | integer | 否 | Quick 协议
| 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 |
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 |
PlayerType | integer | 否 | 播放器,不传默认 12。
| 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 | array<object> | 否 | 监测点列表。 | |
object | 否 | 监测点列表。 | ||
CityCode | string | 否 | 城市编码。 | 100001 |
OperatorCode | string | 否 | 运营商编码。 | 1 |
ClientType | integer | 否 | 拨测点客户端类型:
| 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 | array<object> | 否 | host 列表。 | |
object | 否 | 自定义 host。 | ||
Domain | string | 否 | 域名。 | www.aliyun.com |
IpType | integer | 否 | IP 类型:
| 0 |
Ips | array | 否 | IP 列表。 | |
string | 否 | IP 地址。 | 127.0.0.1 | |
SelectType | integer | 否 | 选择方式:
| 0 |
IpType | integer | 否 | IP 类型:
| 0 |
MonitorSamples | integer | 否 | 是否均匀分配监测样本 :
| 0 |
IsOpenTrace | boolean | 否 | 是否开启链路追踪。 | true |
TraceClientType | integer | 否 | 链路追踪客户端类型:
| 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 |
CustomPrometheusSetting | object | 否 | 保留字段。 | |
PrometheusLabels | object | 否 | 保留字段。 | |
string | 否 | 保留字段。 | 保留字段。 | |
PrometheusClusterId | string | 否 | 保留字段。 | 保留字段。 |
PrometheusClusterRegion | string | 否 | 保留字段。 | 保留字段。 |
AvailableAssertions | array<object> | 否 | 断言列表 | |
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 | array<object> | 否 | 标签列表。 | |
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
返回参数
示例
正常返回示例
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 错误码发生变更 | 查看变更详情 |
2024-03-14 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-03-01 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-02-23 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-01-05 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
2023-11-07 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-10-26 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-09-08 | OpenAPI 错误码发生变更 | 查看变更详情 |