---
title: "下发漏洞快速检测任务"
method: POST
path: "/v1/kb/vuln/task"
tags: ["策略-漏洞列表"]
---

# 下发漏洞快速检测任务

`POST /v1/kb/vuln/task`

## Request

- The document declares no server URL.
- Auth: API key in header `Token`

POST 下发一个漏洞快速检测任务，成功时 data 为空对象 {}。

## Query parameters

- `space` integer, required

## Request body

- TaskRealtimeTaskV2SerializerRequest
  - `id` integer: 主键ID
  - `task_name` string, required: 任务名称
  - `cluster` string: 集群对象。响应返回 {cluster, description}；请求时传集群标识字符串
  - `scope` 'tag' | 'bu' | 'all', required: 资产范围（all=全空间，否则按 scope_data 指定 ID 列表）
  - `scope_data` string: 范围数据。响应返回 ID 整型列表；请求可传整型列表或逗号分隔字符串
  - `class_name` string: 目标类型（product=产品/risk=风险）
  - `data` string, required: 目标数据。响应返回 {id, name}；请求传目标主键ID字符串
  - `status` string: 任务状态

## Response `200`

- KbVulnKbTaskPOSTResponse: 自定义响应
  - `code` integer: 状态码
  - `message` string: 提示信息
  - `data` object: 无返回数据（空对象 {}）

## Other responses

- `401`: 未认证
- `404`: 资源不存在

## Changes

- **2026-11-12** `b4a5be2f291d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chaitin/apis/cloud-atlas-openapi/changes/v1/kb/vuln/task/post.md)

---

[API](https://skmtc.dev/chaitin/apis/cloud-atlas-openapi.md) - [All operations](https://skmtc.dev/chaitin/apis/cloud-atlas-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chaitin/apis/cloud-atlas-openapi/revisions/b4a5be2f291d?raw)
