更新时间:2026-06-26 GMT+08:00
分享

更新工作台 - UpdateWorkbench

功能介绍

更新工作台的名称、分类类型、URL地址、打开方式、标签、描述、图标、发布状态信息。

调用方法

请参见如何调用API

授权信息

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

URI

PUT /v1/{project_id}/workspaces/{workspace_id}/workbenches/{workbench_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workbench_id

String

参数解释:

工作台ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content-type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

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。

取值范围:

默认取值:

不涉及

is_favorite

Boolean

参数解释:

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

约束限制:

取值范围:

  • true

  • false

默认取值:

不涉及

status

String

参数解释:

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

约束限制:

取值范围:

  • PUBLISH

  • UNPUBLISH

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

String

参数解释:

请求成功的编码

约束限制:

不涉及

取值范围:

  • SecMaster.000000

默认值:

不涉及

msg

String

参数解释:

请求成功的消息

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

data

CreateWorkbenchResp object

参数解释:

工作台返回的详情

约束限制:

取值范围:

默认取值:

不涉及

is_favorite

Boolean

参数解释:

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

约束限制:

取值范围:

  • true

  • false

默认取值:

不涉及

status

String

参数解释:

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

约束限制:

取值范围:

  • PUBLISH

  • UNPUBLISH

默认取值:

不涉及

表5 CreateWorkbenchResp

参数

参数类型

描述

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

状态码: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

参数解释:

错误描述

约束限制:

取值范围:

默认取值:

不涉及

请求示例

{
  "name" : "WAF日志审计工作台",
  "type" : "DEFENSE",
  "url" : "https://console.xxxcloud.com/console/xxx/xxxx",
  "url_openwith_type" : "NEW_PAGE",
  "tags" : "智能辅助,应用防线",
  "description" : "云原生WEB应用防火墙应用工作台,可应用于XXXXX场景下运营平台。",
  "icon" : "data:image/png;base64,312312312124",
  "is_favorite" : false,
  "status" : "UNPUBLISH"
}

响应示例

状态码

状态码

描述

200

请求成功

400

请求参数有误

500

请求失败

错误码

请参见错误码

相关文档