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

# 查询漏洞快速检测任务列表

`GET /v1/kb/vuln/task`

## Request

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

GET 返回当前空间下漏洞的快速检测任务（RealtimeTaskV2）分页列表。

## Query parameters

- `space` integer, required

## Response `200`

- KbVulnKbTaskGETResponse: 自定义响应
  - `code` integer: 状态码
  - `message` string: 提示信息
  - `data` object: 分页结果
    - `current` integer: 当前页码
    - `size` integer: 每页数量
    - `total` integer: 数据总量
    - `items` TaskRealtimeTaskV2Serializer[]: 数据列表
      - `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=风险）
      - `task_count` string: 已生成的子任务数
      - `data` string, required: 目标数据。响应返回 {id, name}；请求传目标主键ID字符串
      - `status` string: 任务状态
      - `updated_at` string: 更新时间，格式 YYYY-MM-DD HH:MM:SS，如 2026-08-08 14:30:00

## 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/get.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)
