更新工作台 - UpdateWorkbench
功能介绍
更新工作台的名称、分类类型、URL地址、打开方式、标签、描述、图标、发布状态信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /v1/{project_id}/workspaces/{workspace_id}/workbenches/{workbench_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| workspace_id | 是 | String | 参数解释: 工作空间ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| workbench_id | 是 | String | 参数解释: 工作台ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| content-type | 是 | String | 参数解释: 请求头中内容格式,一般为application/json;charset=UTF-8 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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。 取值范围: 无 默认取值: 不涉及 |
| is_favorite | 否 | Boolean | 参数解释: 工作台的收藏状态,默认为false, 如果已经收藏则为true 约束限制: 无 取值范围: 默认取值: 不涉及 |
| status | 否 | String | 参数解释: 工作台发布状态,已发布(PUBLISH), 未发布(UNPUBLISH) 约束限制: 无 取值范围: 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 参数解释: 请求成功的编码 约束限制: 不涉及 取值范围: 默认值: 不涉及 |
| msg | String | 参数解释: 请求成功的消息 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| data | CreateWorkbenchResp object | 参数解释: 工作台返回的详情 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
| is_favorite | Boolean | 参数解释: 工作台的收藏状态,默认为false, 如果已经收藏则为true 约束限制: 无 取值范围: 默认取值: 不涉及 |
| status | String | 参数解释: 工作台发布状态,已发布(PUBLISH), 未发布(UNPUBLISH) 约束限制: 无 取值范围: 默认取值: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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) 取值范围: |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码 约束限制: 无 取值范围: Secmaster.000000~Secmaster.99999 默认取值: 不涉及 |
| error_msg | String | 参数解释: 错误描述 约束限制: 无 取值范围: 无 默认取值: 不涉及 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 请求失败 |
错误码
请参见错误码。