文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ Workbench/ 工作台列表查询 - ListWorkbenches
更新时间:2026-06-26 GMT+08:00
分享

工作台列表查询 - ListWorkbenches

功能介绍

工作台列表查询接口,可以根据创建者,状态,以及全局过滤值进行工作台筛选

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

GET /v1/{project_id}/workspaces/{workspace_id}/workbenches

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

分布参数中的偏移量,一般理解为第几页

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

limit

Integer

参数解释:

分布参数中的页大小,一般理解为本次请示获取的最大数据量

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

global_search_text

String

参数解释:

全局搜索关键字搜索、过滤

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

creator_type

String

参数解释:

创建类型系统创建的工作台(system)、我创建的工作台(mine)、其他人创建的工作台(others)

约束限制:

不涉及

取值范围:

  • system

  • mine

  • others

默认取值:

不涉及

status

String

参数解释:

工作台状态,状态分为已发布(publish)、未发布(unpublish)

约束限制:

不涉及

取值范围:

  • publish

  • unpublish

默认取值:

不涉及

name

String

参数解释:

工作台名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

type

String

参数解释:

工作台类型,状态分为场景工作台(scenario)、防线工作台(defense)

约束限制:

不涉及

取值范围:

  • scenario

  • defense

默认取值:

不涉及

url

String

参数解释:

工作台url

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

tags

String

参数解释:

工作台标签,可以输入多个标签中的一个进行查询

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

from_date

String

参数解释:

查询工作台创建时间区间的开始

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

to_date

String

参数解释:

查询工作台创建时间区间的结束

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content-type

String

参数解释:

请求头中内容格式,一般为application/json;charset=UTF-8

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

String

参数解释:

请求成功的编码

约束限制:

不涉及

取值范围:

  • SecMaster.000000

默认值:

不涉及

msg

String

参数解释:

请求成功的消息

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

total

Integer

参数解释:

返回的数据总数

约束限制:

取值范围:

默认取值:

不涉及

limit

Integer

参数解释:

当前页大小

约束限制:

取值范围:

默认取值:

不涉及

offset

Integer

参数解释:

当前页码

约束限制:

取值范围:

默认取值:

不涉及

data

Array of ListWorkbenchResponse objects

参数解释:

工作台列表数据集

约束限制:

取值范围:

默认取值:

不涉及

表5 ListWorkbenchResponse

参数

参数类型

描述

name

String

参数解释:

工作台名称

约束限制:

不涉及

取值范围:

默认取值:

不涉及

type

String

参数解释:

工作台的分类,防线工作台(DEFENSE)或者场景工作台(SCENARIO)

约束限制:

不涉及

取值范围:

  • DEFENSE: 防线工作台

SCENARIO: 场景工作台

默认取值:

不涉及

url

String

参数解释:

工作台主页地址,可以选择云脑中已有的工作台布局,也可以选择云上console上的URL页面地址

约束限制:

不涉及

取值范围:

默认取值:

不涉及

url_openwith_type

String

参数解释:

工作台主页打开方式, NEW_PAGE 新页面打开, CURRENT_PAGE 原页面打开

约束限制:

不涉及

取值范围:

  • NEW_PAGE: 新页面打开工作台

CURRENT_PAGE: 原页面打开工作台

默认取值:

不涉及

tags

String

参数解释:

工作台标签,多个标签以逗号隔开

约束限制:

最多不超过10个标签

取值范围:

默认取值:

不涉及

description

String

参数解释:

工作台的描述

约束限制:

长度不超过512个字符

取值范围:

默认取值:

不涉及

icon

String

参数解释:

工作台的图标,在页面上选择一个图片图标作为工作台图标。

约束限制:

限制像素为16X16, 大小小于2KB。

取值范围:

默认取值:

不涉及

basic_properties

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

domain_id

String

参数解释:

账号ID,用于明确当前资源所属账号,配置后可通过该ID查询账号下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

region_id

String

参数解释:

区域ID,用于明确区域归属,配置后可通过该ID查询区域下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间ID,用于明确工作空间归属,配置后可通过该ID查询工作空间下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

create_time

String

参数解释:

工作台创建时间

约束限制:

取值范围:

默认取值:

不涉及

id

String

参数解释:

工作台ID,通常是UUID

约束限制:

取值范围:

默认取值:

不涉及

creator_id

String

参数解释:

工作台的创建人,通常为IAM用户ID

约束限制:

取值范围:

默认取值:

不涉及

creator_name

String

参数解释:

工作台的创建人名称,通常的当前用户的用户名

约束限制:

取值范围:

默认取值:

不涉及

is_deleted

Boolean

参数解释:

工作台的删除状态,默认为false, 如果已经删除则为true

约束限制:

取值范围:

默认取值:

不涉及

is_favorite

Boolean

参数解释:

工作台的收藏状态,默认为false, 如果已经收藏则为true

约束限制:

取值范围:

  • true

  • false

默认取值:

不涉及

status

String

参数解释:

工作台发布状态,已发布(PUBLISH), 未发布(UNPUBLISH)

取值范围:

  • PUBLISH

  • UNPUBLISH

update_time

String

参数解释:

工作台更新时间

约束限制:

取值范围:

默认取值:

不涉及

modifier_id

String

参数解释:

工作台的修改人,通常为IAM的用户ID

约束限制:

取值范围:

默认取值:

不涉及

modifier_name

String

参数解释:

工作台的修改人名称,通常为用户名称

约束限制:

取值范围:

默认取值:

不涉及

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

约束限制:

取值范围:

Secmaster.000000~Secmaster.99999

默认取值:

不涉及

error_msg

String

参数解释:

错误描述

约束限制:

取值范围:

默认取值:

不涉及

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

约束限制:

取值范围:

Secmaster.000000~Secmaster.99999

默认取值:

不涉及

error_msg

String

参数解释:

错误描述

约束限制:

取值范围:

默认取值:

不涉及

请求示例

响应示例

状态码

状态码

描述

200

请求成功

400

请求参数有误

500

请求失败

错误码

请参见错误码

相关文档