云拨测
云拨测
文档指南
请输入
- 文档首页
云拨测API 参考拨测任务（V1）ListTask - 获取周期拨测任务列表
复制全文
下载 pdfListTask - 获取周期拨测任务列表
文档反馈
问问助手调用 ListTask 接口，查看周期拨测任务列表。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListTask
要执行的操作，取值：ListTask。
Version string 必选 示例值：2023-08-31
API的版本，取值：2023-08-31。
PageNum long 必选 示例值：1
指定要检索的页码。
PageSize long 必选 示例值：20
指定每页显示的任务数量。
TagFilters object[] 可选 示例值：--
任务标签列表。
支持按系统标签或用户标签筛选，多个key的关系为“或”，多个value的关系为“或”，匹配模式为“精确匹配”。
Key string 必选 示例值：k1
标签键，长度限制在1~128个字符之间。
Values string[] 可选 示例值：v1
标签值。
- 长度限制在0~256个字符之间。
- 允许任何语言的文字、数字、空格和符号“:.:/=+-@”。
ProjectName string 可选 示例值：default
资源所属项目名称。
Name string 可选 示例值：http-test
根据任务名称进行筛选，支持子串匹配。
ID string 可选 示例值：23309014
根据任务ID进行筛选，支持子串匹配。
Address string 可选 示例值：https://www.example.com
根据目标地址进行筛选，支持子串匹配。
Owner string 可选 示例值：root
根据创建人进行筛选，支持子串匹配。
返回参数
PageSize long 示例值：10
分页大小。
PageNum long 示例值：1
分页号码。
Total long 示例值：100
总条数。
TaskList object[] 示例值：--
一个对象数组，包含了任务的详细信息列表。
ID long 示例值：23286778
任务ID。
Name string 示例值：cloud-detect-test
任务名称。
Address string 示例值：http://www.example.com
目标地址。
Labels object[] 示例值：--
任务的标签信息。
KeyID long 示例值：101
标签的唯一标识符，不需要传递。
OptionID long 示例值：201
与标签关联的选项ID。
Key string 示例值：protocol
标签的键，仅在返回值有效时提供。
Option string 示例值：icmp
标签的值，仅在返回值有效时提供。
HTTPMethod integer 示例值：1
HTTP方法。其中：
- 1：GET
- 2：POST
- 3：PUT
- 4：DELETE
- 5：PATCH
- 6：HEAD
- 7：OPTIONS
Status integer 示例值：2
任务状态：
- 2：运行中
- 4：已暂停
- 6：已结束
TaskType integer 示例值：14
任务类型。其中：
- 11：PING
- 12：HTTP(S)
- 13：DNS
- 14：TCP/UDP
- 15：文件传输
- 16：页面元素
SubTaskType integer 示例值：6
任务子类型。可选值：
- 1：HTTP(S)
- 2：DNS
- 3：PING
- 5：UDP
- 6：TCP
- 8: 上传
- 9: 下载
- 11: 页面元素
TaskGroupID long 示例值：0
任务组ID。0表示未绑定任务组。
TaskGroupName string 示例值：group_one
任务组名称，查询时返回。
IntervalSeconds integer 示例值：60
拨测频率。单位：秒（s）。
FinishTime long 示例值：0
结束时间，秒级时间戳，0代表不限结束时间。
EnableShuffle boolean 示例值：true
均匀分配样本开关。
PeriodConfig object 示例值：--
自定义执行周期。
Period integer 示例值：1
执行周期。可选值：
- 1：每天
- 2：每周
- 3：每月
Days long[] 示例值：[1, 2, 3, 4, 5]
执行日，当执行周期为周或月时必填。
TimeRangeConfig object[] 示例值：--
自定义时间段配置，存储了多段时间范围以及对应的拨测频率。
StartTime object 示例值：--
每日执行开始时间。
Hour integer 示例值：09
开始小时，00~23。
Minute integer 示例值：00
开始分钟，00~59。
EndTime object 示例值：--
每日执行结束时间。
Hour integer 示例值：09
开始小时，00~23。
Minute integer 示例值：00
开始分钟，00~59。
Interval long 示例值：60
拨测频率，0为不执行。可选值：0、60、120、180、300、600、900、1200、1800、3600、7200、10800、21600、43200、86400。
ResultAssert object 示例值：--
任务断言配置。
Relation string 示例值：and
断言条件关系：
- and
- or
DNSHijackConfig object 示例值：--
DNS劫持配置。
DNSHijackAllowList object[] 示例值：--
劫持白名单。
Host string 示例值：www.example.com
劫持主机名，长度≥1。
HijackList string[] 示例值：[1.1.1.1]
劫持判定列表，列表长度≥1。
DNSHijackBlockList object[] 示例值：--
劫持黑名单。
Host string 示例值：www.example.com
劫持主机名，长度≥1。
HijackList string[] 示例值：[1.1.1.1]
劫持判定列表，列表长度≥1。
PageConfig object 示例值：--
页面元素任务配置。
Cookies object[] 示例值：--
设置请求的cookie。
Name string 示例值：digest
cookie名称。
Value string 示例值：value
cookie值。
Domain string 示例值：www.example.com
cookie域名。
Timeout long 示例值：40
超时时间。取值范围：[5,300]，默认值：40。
AutoScroll boolean 示例值：true
是否自动滚屏，默认关闭。
QuicConfig object 示例值：--
QUIC配置。
QuicVersion integer 示例值：0
QUIC版本，可选值：
- 0（默认）： Default，浏览器默认版本，不会强制QUIC版本
- 9000：H3
- 29：H3Draft29
- 43：Q043
- 46：Q046
- 50：Q050
ForceQuicHost string[] 示例值：["abc.com"]
强制使用QUIC的主机列表。若不传入，所有域名都会统一按照配置的QuicVersion执行QUIC协议；若传入，列表中指定的域名会优先按照配置的QuicVersion执行。
EnableCache boolean 示例值：true
是否开启缓存，默认开启。
CustomHeader object 示例值：--
自定义请求头。
Type integer 示例值：1
自定义请求头修改类型，可选值：
- 1（默认）：关闭
- 3：修改全部包
Values object 示例值：{"key":"value"}
自定义请求value。
SaveElements boolean 示例值：true
是否返回全部元素，默认开启。
EnableRedirect boolean 示例值：true
是否开启重定向，默认开启。
DisableCompress boolean 示例值：true
是否禁止压缩，需拨测目标的服务端支持。默认值：false。
IgnoreCertificate boolean 示例值：true
是否忽略证书校验，默认值：false。
SaveFinalSnapshot integer 示例值：1
是否保存最终截图快照。
- 1（默认）：不保存
- 2：保存
ScreenshotKeypoint boolean 示例值：true
关键点截图，默认值：false。
SaveBaseDocumentBody boolean 示例值：true
是否保存基础文档响应体，当前仅支持text/html和application/json。默认值：false。
EndCustomHostConfigTime object 示例值：--
自定义解析/主机名配置。
Strategy integer 示例值：1
下发策略。可选值：
- 1：随机
- 2：轮询
CustomHosts object[] 示例值：--
自定义的主机列表，每个对象包含原始主机名和解析列表。
RawHostPort string 示例值：example.com:80
域名。格式为host:port, port可省略。长度大于0。
ResolveList string[] 示例值：127.0.0.1:8080、[0:0:0:0:0:0:0:1]:8080
指定解析ip,caname list，格式为host:port，port可省略。列表长度大于0。
说明
当IP为IPv6时，Host需用英文中括号包裹。
UploadConfig object 示例值：--
文件传输-上传任务配置。
Method integer 示例值：1
HTTP方法，可选值：
- 拨测方式为下载时，取值为1：GET。
- 拨测方式为上传时，取值：
- 2：POST
- 3：PUT
DNSType string 示例值：system
指定DNS服务器，可选值：
- system（默认）：系统默认
- custom：自定义DNS
- doh: DoH URL
- isp：运营商DNS
Headers object[] 示例值：--
HTTP header，最大设置100个。
Key string 示例值：User-Agent
表示请求头部的键。
Value string 示例值：Mozilla/5.0 (Windows NT 10.0; Win64; x64)
表示请求头部的值。
Queries object[] 示例值：--
HTTP query参数，最大设置100个。
Key string 示例值：User-Agent
表示请求头部的键。
Value string 示例值：Mozilla/5.0 (Windows NT 10.0; Win64; x64)
表示请求头部的值。
Timeout integer 示例值：30
超时时间，取值范围：1~120秒。
Redirect boolean 示例值：true
是否开启重定向，默认值：false。
DNSServer string 示例值：114.114.114.114
指定DNS服务器地址：
- 当DNSType为system或isp时，忽略当前值。
- 当DNSType为custom时，必须是合法的IP地址。
- 当DNSType为doh时，填写DoH地址，即：以https://开头的URL。
HTTPVersion string 示例值：auto
HTTP版本，可选值：
- auto（默认）：自动协商
- http/1.1：HTTP/1.1
- h2：HTTP2
- h3：HTTP/3(RFC9000)
UploadFileURL string 示例值：https://example.com/file
待上传文件的下载地址，长度小于1KB，若未填写，则随机生成文件内容。
MaxTransferSize long 示例值：1024
最大请求/响应体，单位Byte，最大为20MB。
CustomHostConfig object 示例值：--
自定义Host。
Strategy integer 示例值：1
下发策略。可选值：
- 1：随机
- 2：轮询
CustomHosts object[] 示例值：--
自定义的主机列表，每个对象包含原始主机名和解析列表。
RawHostPort string 示例值：example.com:80
域名。格式为host:port, port可省略。长度大于0。
ResolveList string[] 示例值：127.0.0.1:8080、[0:0:0:0:0:0:0:1]:8080
指定解析ip,caname list，格式为host:port，port可省略。列表长度大于0。
说明
当IP为IPv6时，Host需用英文中括号包裹。
IgnoreCertificate boolean 示例值：true
忽略证书验证，默认值：false。
DownloadConfig object 示例值：--
文件传输-下载任务配置。
Method integer 示例值：1
HTTP方法，可选值：
- 拨测方式为下载时，取值为1：GET。
- 拨测方式为上传时，取值：
- 2：POST
- 3：PUT
DNSType string 示例值：system
指定DNS服务器，可选值：
- system（默认）：系统默认
- custom：自定义DNS
- doh: DoH URL
- isp：运营商DNS
Headers object[] 示例值：--
HTTP header，最大设置100个。
Key string 示例值：User-Agent
表示请求头部的键。
Value string 示例值：Mozilla/5.0 (Windows NT 10.0; Win64; x64)
表示请求头部的值。
Queries object[] 示例值：--
HTTP query参数，最大设置100个。
Key string 示例值：User-Agent
表示请求头部的键。
Value string 示例值：Mozilla/5.0 (Windows NT 10.0; Win64; x64)
表示请求头部的值。
Timeout integer 示例值：30
超时时间，取值范围：1~120秒。
Redirect boolean 示例值：true
是否开启重定向，默认值：false。
DNSServer string 示例值：114.114.114.114
指定DNS服务器地址：
- 当DNSType为system或isp时，忽略当前值。
- 当DNSType为custom时，必须是合法的IP地址。
- 当DNSType为doh时，填写DoH地址，即：以https://开头的URL。
HTTPVersion string 示例值：auto
HTTP版本，可选值：
- auto（默认）：自动协商
- http/1.1：HTTP/1.1
- h2：HTTP2
- h3：HTTP/3(RFC9000)
UploadFileURL string 示例值：https://example.com/file
待上传文件的下载地址，长度小于1KB，若未填写，则随机生成文件内容。
MaxTransferSize long 示例值：1024
最大请求/响应体，单位Byte，最大为20MB。
CustomHostConfig object 示例值：--
自定义Host。
Strategy integer 示例值：1
下发策略。可选值：
- 1：随机
- 2：轮询
CustomHosts object[] 示例值：--
自定义的主机列表，每个对象包含原始主机名和解析列表。
RawHostPort string 示例值：example.com:80
域名。格式为host:port, port可省略。长度大于0。
ResolveList string[] 示例值：127.0.0.1:8080、[0:0:0:0:0:0:0:1]:8080
指定解析ip,caname list，格式为host:port，port可省略。列表长度大于0。
说明
当IP为IPv6时，Host需用英文中括号包裹。
IgnoreCertificate boolean 示例值：true
忽略证书验证，默认值：false。
Owner string 示例值：root
任务创建人。
CreateTime long 示例值：1734660749
任务创建时间。
UpdateTime long 示例值：1734660749
任务更新时间。
Tags object[] 示例值：--
资源绑定的标签信息。
Key string 示例值：k1
标签键，长度限制在1~128个字符之间。
Value string 示例值：v1
标签值。
- 长度限制在0~256个字符之间。
- 允许任何语言的文字、数字、空格和符号“:.:/=+-@”。
Type integer 示例值：1
任务类型。其中：
- 1：HTTP(S)
- 2：DNS
- 3：PING
- 5：UDP
- 6：TCP
- 8: 上传
- 9: 下载
- 11: 页面元素
LineIDList long[] 示例值：null
表示节点ID列表。
IDStr string 示例值：23286778
Id string ，查询时返回，用于RMS获取资源ID。
RunnerIDList long[] 示例值：null
表示私有节点ID列表。
AlarmList object[] 示例值：--
告警策略列表。
ID long 示例值：10222
告警策略ID。
Name string 示例值：策略名称
告警策略名称。
Status integer 示例值：2
告警策略状态。
AlarmIDList long[] 示例值：[1,2]
告警策略ID列表。
ProjectName string 示例值：default
拨测任务所属项目名称。
CreateTimeStr string 示例值：2023-08-31T00:00:00
创建时间。format格式：YYYY-MM-DD'T'HH:MM:SS'Z' ，用于RMS获取资源创建时间使用。
TargetServerType integer 示例值：1
目标服务器类型。可选值：
- 1：IPv4
- 2：IPv6
- 3：自动
Pagination object 示例值：--
表示查询结果的分页信息。
PageNum long 示例值：1
当前页码。
PageSize long 示例值：20
每页的数据条数。
Total long 示例值：100
总数据条数。
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
200 | AccessDenied | User is not authorized to perform: cloud_detect:{Action} on resource: | 无权限进行此操作及对应资源。 |
最近更新时间：2025.10.28 17:54:33
这个页面对您有帮助吗？
有用
有用
无用
无用