工作台列表查询 - ListWorkbenches
功能介绍
工作台列表查询接口,可以根据创建者,状态,以及全局过滤值进行工作台筛选
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/workspaces/{workspace_id}/workbenches
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| workspace_id | 是 | String | 参数解释: 工作空间ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 是 | Integer | 参数解释: 分布参数中的偏移量,一般理解为第几页 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| limit | 是 | Integer | 参数解释: 分布参数中的页大小,一般理解为本次请示获取的最大数据量 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| global_search_text | 否 | String | 参数解释: 全局搜索关键字搜索、过滤 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| creator_type | 否 | String | 参数解释: 创建类型系统创建的工作台(system)、我创建的工作台(mine)、其他人创建的工作台(others) 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| status | 否 | String | 参数解释: 工作台状态,状态分为已发布(publish)、未发布(unpublish) 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| name | 否 | String | 参数解释: 工作台名称 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| type | 否 | String | 参数解释: 工作台类型,状态分为场景工作台(scenario)、防线工作台(defense) 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| url | 否 | String | 参数解释: 工作台url 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| tags | 否 | String | 参数解释: 工作台标签,可以输入多个标签中的一个进行查询 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| from_date | 否 | String | 参数解释: 查询工作台创建时间区间的开始 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| to_date | 否 | String | 参数解释: 查询工作台创建时间区间的结束 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| content-type | 是 | String | 参数解释: 请求头中内容格式,一般为application/json;charset=UTF-8 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 参数解释: 请求成功的编码 约束限制: 不涉及 取值范围: 默认值: 不涉及 |
| msg | String | 参数解释: 请求成功的消息 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| total | Integer | 参数解释: 返回的数据总数 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| limit | Integer | 参数解释: 当前页大小 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| offset | Integer | 参数解释: 当前页码 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| data | Array of ListWorkbenchResponse objects | 参数解释: 工作台列表数据集 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: 工作台名称 约束限制: 不涉及 取值范围: 无 默认取值: 不涉及 |
| type | String | 参数解释: 工作台的分类,防线工作台(DEFENSE)或者场景工作台(SCENARIO) 约束限制: 不涉及 取值范围: SCENARIO: 场景工作台 默认取值: 不涉及 |
| url | String | 参数解释: 工作台主页地址,可以选择云脑中已有的工作台布局,也可以选择云上console上的URL页面地址 约束限制: 不涉及 取值范围: 无 默认取值: 不涉及 |
| url_openwith_type | String | 参数解释: 工作台主页打开方式, NEW_PAGE 新页面打开, CURRENT_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 约束限制: 无 取值范围: 默认取值: 不涉及 |
| status | String | 参数解释: 工作台发布状态,已发布(PUBLISH), 未发布(UNPUBLISH) 取值范围: |
| update_time | String | 参数解释: 工作台更新时间 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| modifier_id | String | 参数解释: 工作台的修改人,通常为IAM的用户ID 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| modifier_name | String | 参数解释: 工作台的修改人名称,通常为用户名称 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码 约束限制: 无 取值范围: Secmaster.000000~Secmaster.99999 默认取值: 不涉及 |
| error_msg | String | 参数解释: 错误描述 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码 约束限制: 无 取值范围: Secmaster.000000~Secmaster.99999 默认取值: 不涉及 |
| error_msg | String | 参数解释: 错误描述 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数有误 |
| 500 | 请求失败 |
错误码
请参见错误码。