云拨测
云拨测
文档指南
请输入
- 文档首页
云拨测API 参考拨测任务（V2）GetTask - 获取周期拨测任务详情
复制全文
下载 pdfGetTask - 获取周期拨测任务详情
文档反馈
问问助手调用 GetTask 接口，查看周期任务的详细信息。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：GetTask
要执行的操作，取值：GetTask。
Version string 必选 示例值：2025-10-31
API的版本，取值：2025-10-31。
Id long 必选 示例值：23295301
任务ID。
ProjectName string 可选 示例值：default
项目名称。
返回参数
Task object 示例值：--
任务信息。
Name string 示例值：cloud-detect-test
任务名称。
Address string 示例值：http://www.example.com
目标地址。
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: 页面元素
TaskGroupName string 示例值：group_one
任务组名称，查询时返回。
IntervalSeconds integer 示例值：60
拨测频率。单位：秒（s）。
结束时间，秒级时间戳，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
DiagnoseConfig object 示例值：--
诊断配置。
PingConfig object 示例值：--
PING配置。
ProtocolType integer 示例值：1
协议类型。可选值：
- 1（默认）：ICMP
- 2：TCP
- 3：UDP
Timeout integer 示例值：20
超时时间。取值范围：[1,60]。默认值：20。
ExecuteInterval double 示例值：0.5
执行间隔，单位：秒（s）。
- 可选值：0.2、0.5、1、2、3、4、5、10。
- 默认值：0.2。
PackagesNum integer 示例值：4
包数量。取值范围：(0,100]。默认值：4。
PackagesSize integer 示例值：32
包大小。
- 可选值：32、64、128、256、512、1024、1080、1450。
- 默认值：32。
EnableDividePackage boolean 示例值：true
是否切分包。可选值：
- false：不切分。
- true（默认）：切分。
ConnectTimeout double 示例值：0.5
单次监测超时、TCPing的单次建联超时时间。单位为秒（s）。取值范围：[0.01,10]。默认值：0.5。
MtrConfig object 示例值：--
MTR配置。
PackageType integer 示例值：1
包数据类型。探测包类型，可选值：
- 1（默认）：ICMP
- 2：TCP
- 3：UDP
Interval double 示例值：0.2
探测间隔。单位：秒（s）。取值范围：[0,1]。默认值：0.2。
PackageNum integer 示例值：4
发包数。单位：个。取值范围：[1,16]。默认值：4。
PackageSize integer 示例值：32
包大小。单位：bytes。取值范围：[1,128]。默认值：32。
MaxHops integer 示例值：30
最大跳数。单位：个。取值范围：[1,60]。默认值：30。
MaxUnknownHost integer 示例值：10
最大未知主机数。单位：个。取值范围：[1,60]。默认值：5。
Timeout integer 示例值：10
超时时间。单位：秒（s）。默认值：10。
DnsReverseResolution boolean 示例值：true
是否开启DNS逆向解析。默认值为false。
PcapStatus integer 示例值：1
表示抓包配置。可选值：
- 0：不抓包
- 1：总是抓包
- 2：失败时抓包
MethodList integer[] 示例值：2
诊断方法列表。可选值：
- 1：PING
- 2：DNS
- 3：MTR
DnsConfig object 示例值：--
DNS配置。
Timeout integer 示例值：5
超时时间。单位：秒（s）。取值范围：(0,45)。默认值：5。
SearchType integer 示例值：1
查询方式。可选值：
- 1（默认）：递归
- 2：迭代
Server string 示例值：dns.example.com
DNS服务器地址。
ServerType integer 示例值：3
DNS服务器类型。可选值：
- 1：IPv4
- 2：IPv6
- 3：自动
默认值：3。
EnableDig boolean 示例值：true
是否使用dig命令格式检测结果。默认值：true。
RecordType integer 示例值：1
指定查询的记录类型。可选值：
- 1：A
- 2：AAAA
- 3：CNAME
- 4：MX
- 5：TXT
- 6：PTR
不设置时会自动根据TargetServerType（目标服务器类型）来指定A或者AAAA。
PingConfig object 示例值：--
网络质量任务配置。
ProtocolType integer 示例值：1
协议类型。可选值：
- 1（默认）：ICMP
- 2：TCP
- 3：UDP
Timeout integer 示例值：20
超时时间。取值范围：[1,60]。默认值：20。
ExecuteInterval double 示例值：0.5
执行间隔，单位：秒（s）。
- 可选值：0.2、0.5、1、2、3、4、5、10。
- 默认值：0.2。
PackagesNum integer 示例值：4
包数量。取值范围：(0,100]。默认值：4。
PackagesSize integer 示例值：32
包大小。
- 可选值：32、64、128、256、512、1024、1080、1450。
- 默认值：32。
EnableDividePackage boolean 示例值：true
是否切分包。可选值：
- false：不切分。
- true（默认）：切分。
ConnectTimeout double 示例值：0.5
单次监测超时、TCPing的单次建联超时时间。单位为秒（s）。取值范围：[0.01,10]。默认值：0.5。
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。
CustomHostConfig 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需用英文中括号包裹。
IgnoreCertificate boolean 示例值：true
是否忽略证书校验，默认值：false。
SaveFinalSnapshot integer 示例值：1
是否保存最终截图快照。
- 1（默认）：不保存
- 2：保存
ScreenshotKeypoint boolean 示例值：true
关键点截图，默认值：false。
SaveBaseDocumentBody boolean 示例值：true
是否保存基础文档响应体，当前仅支持text/html和application/json。默认值：false。
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 示例值：X-Volcengine-Platform
HTTP头部的名称。
Value string 示例值：cloud-detect
HTTP头部的值，对应于Key的值。
Queries object[] 示例值：--
HTTP query参数，最大设置100个。
Key string 示例值：X-Volcengine-Platform
HTTP头部的名称。
Value string 示例值：cloud-detect
HTTP头部的值，对应于Key的值。
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 示例值：X-Volcengine-Platform
HTTP头部的名称。
Value string 示例值：cloud-detect
HTTP头部的值，对应于Key的值。
Queries object[] 示例值：--
HTTP query参数，最大设置100个。
Key string 示例值：X-Volcengine-Platform
HTTP头部的名称。
Value string 示例值：cloud-detect
HTTP头部的值，对应于Key的值。
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
任务更新时间。
Id long 示例值：23286778
任务ID。
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: 页面元素
IdStr string 示例值：23286778
Id string ，查询时返回，用于RMS获取资源ID。
AlarmList object[] 示例值：--
告警策略列表。
Id long 示例值：10222
告警策略ID。
Name string 示例值：策略名称
告警策略名称。
Status integer 示例值：2
告警策略状态。
HttpMethod integer 示例值：1
HTTP方法，仅HTTP和上传/下载任务时返回该参数。
- 1：GET
- 2：POST
- 3：PUT
- 4：DELETE
- 5：PATCH
- 6：HEAD
- 7：OPTIONS
LineIdList long[] 示例值：null
表示节点ID列表。
AlarmIdList long[] 示例值：[1,2]
告警策略ID列表。
ProjectName string 示例值：default
拨测任务所属项目名称。
TaskGroupId long 示例值：0
任务组ID。0表示未绑定任务组。
CreateTimeStr string 示例值：2023-08-31T00:00:00
创建时间。format格式：YYYY-MM-DD'T'HH:MM:SS'Z' ，用于RMS获取资源创建时间使用。
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。
TargetServerType integer 示例值：1
目标服务器类型。可选值：
- 1：IPv4
- 2：IPv6
- 3：自动
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
200 | AccessDenied | User is not authorized to perform: cloud_detect:{Action} on resource: | 无权限进行此操作及对应资源。 |
最近更新时间：2026.02.13 11:09:37
这个页面对您有帮助吗？
有用
有用
无用
无用