创建一个即时漏洞扫描任务并下发到生效范围内的用户终端设备。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TaskName |
string |
是 |
任务名称。长度不超过 128 个字符，支持中文、大小写英文字母、数字及半角句点（.）、下划线（_）、连字符（-），不支持空格。 |
研发部门漏洞扫描 |
| TaskDescription |
string |
否 |
任务描述。 |
对研发部门终端执行一次漏洞扫描 |
| MatchMode |
string |
是 |
生效范围的匹配方式。取值：
枚举值：
|
UserGroupNormal |
| UserGroupIds |
array |
否 |
生效的用户组 ID 集合。MatchMode 取值为 UserGroupNormal 时必填，取值为 UserGroupAll 时不允许传入。传入时至少包含 1 个，最多包含 100 个，不允许重复。 |
|
|
string |
否 |
用户组 ID。取值来源：
|
usergroup-9d4f2a7b3c1e**** |
|
| Whitelist |
array |
否 |
例外用户名单，名单内的用户不执行本次扫描。最多包含 1000 个，不允许重复。 |
|
|
string |
否 |
用户名。长度不超过 128 个字符，支持中文、大小写英文字母、数字及半角句点（.）、下划线（_）、星号（*）、连字符（-）、@、空格、中间点（·）、圆括号。 |
王先生 |
|
| EndTimestamp |
integer |
否 |
任务失效时间，秒级 Unix 时间戳。到达该时间后终端不再拉取执行本任务，未完成的扫描不再继续。 |
1786291200 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次请求的 ID。 |
3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7 |
| TaskId |
string |
创建的漏洞扫描任务 ID。 |
vul-scan-task-4d7b1e9a6c38**** |
示例
正常返回示例
JSON格式
{
"RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
"TaskId": "vul-scan-task-4d7b1e9a6c38****"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。