文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 数据类类型/ 数据类类型修改 - UpdateDataclassType
更新时间:2026-06-26 GMT+08:00
分享

数据类类型修改 - UpdateDataclassType

功能介绍

自定义数据类类型不允许修改,只允许自定义数据类类型修改描述、sla

调用方法

请参见如何调用API

授权信息

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

URI

PUT /v1/{project_id}/workspaces/{workspace_id}/soc/dataclasses/{dataclass_id}/types/{dataclass_type_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

dataclass_id

String

参数解释:

数据类的唯一ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

dataclass_type_id

String

参数解释:

类型id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content-type

String

参数解释:

内容类型

  • application/json;charset=UTF-8 普通API请求的类型

约束限制:

不涉及

取值范围:

  • application/json;charset=UTF-8

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

sla

Long

参数解释:

响应时长

约束限制:

不涉及

取值范围:

0 - 15634800000

默认取值:

不涉及

enabled

Boolean

参数解释:

启用状态

约束限制:

不涉及

取值范围:

  • true

  • false

默认取值:

不涉及

description

String

参数解释:

类型描述

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释:

类型id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

dataclass_id

String

参数解释:

数据类id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

domain_id

String

参数解释:

账号id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

project_id

String

参数解释:

项目id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

region_id

String

参数解释:

局点id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

layout_id

String

参数解释:

布局id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

layout_name

String

参数解释:

布局名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

category

String

参数解释:

数据类类型分类

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

category_code

String

参数解释:

数据类类型分类编码

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

sub_category

String

参数解释:

数据类子类型名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

sub_category_code

String

参数解释:

数据类子类型业务编码

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

description

String

参数解释:

数据类子类型描述

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

enabled

Boolean

参数解释:

类型启用状态

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

level

Integer

参数解释:

类型层级

约束限制:

不涉及

取值范围:

大类:1,子类型:2

默认取值:

不涉及

is_built_in

Boolean

参数解释:

是否内置,true内置,false非内置

约束限制:

不涉及

取值范围:

大类:1,子类型:2

默认取值:

不涉及

sla

Long

参数解释:

响应时长

约束限制:

不涉及

取值范围:

0-15634800000

默认取值:

不涉及

creator_id

String

参数解释:

创建人id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

creator_name

String

参数解释:

创建人名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

modifier_id

String

参数解释:

修改人id

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

modifier_name

String

参数解释:

修改人名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

create_time

String

参数解释:

创建时间

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

update_time

String

参数解释:

修改时间

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

dataclass_business_code

String

参数解释:

所属数据类业务编码

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

sub_count

Integer

参数解释:

类型分类下子类型数目

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

message

String

参数解释:

错误描述

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求示例

修改自定义类型请求示例

{
  "enabled" : true,
  "sla" : 0,
  "description" : "test"
}

响应示例

状态码:200

成功响应

{
  "category" : "TestAlertCategory",
  "category_code" : "Test Alert Category Code",
  "create_time" : "2025-12-19T17:31:27Z+0800",
  "creator_id" : "b40b54b1f27a4224aa0c95ede5b5a46a",
  "creator_name" : "l00644738",
  "dataclass_business_code" : "Alert",
  "dataclass_id" : "",
  "description" : "",
  "domain_id" : "",
  "enabled" : true,
  "id" : "2312dad0-0fc0-314d-bf18-5a87e99c3b16",
  "is_built_in" : false,
  "layout_id" : "",
  "layout_name" : "",
  "level" : null,
  "modifier_id" : "",
  "modifier_name" : "",
  "project_id" : "15645222e8744afa985c93dab6341da6",
  "region_id" : "",
  "sla" : 86400000,
  "sub_category" : "TestAlertSubType",
  "sub_category_code" : "Test Alert Sub Type Code",
  "sub_count" : null,
  "update_time" : null,
  "workspace_id" : "ea956472-44a9-47d6-808b-03b95d06f355"
}

状态码

状态码

描述

200

成功响应

400

失败响应

错误码

请参见错误码

相关文档