文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 数据类类型/ 数据类类型修改 - UpdateDataclassType
更新时间:2026-09-24 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请求的类型

默认取值:

不涉及

表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

参数解释:

类型启用状态。

取值范围:

  • true:启用

  • false:禁用

level

Integer

参数解释:

类型层级

取值范围:

  • 1:大类

  • 2:子类型

is_built_in

Boolean

参数解释:

是否内置

取值范围:

  • true:内置

  • false:非内置

sla

Long

参数解释:

响应时长,单位为毫秒。

取值范围:

0-15634800000(毫秒)

creator_id

String

参数解释:

创建人id

取值范围:

不涉及

creator_name

String

参数解释:

创建人名称

取值范围:

不涉及

modifier_id

String

参数解释:

修改人id

取值范围:

不涉及

modifier_name

String

参数解释:

修改人名称

取值范围:

不涉及

create_time

String

参数解释:

创建时间,使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ssZ。

示例:2021-01-30T23:00:00Z

update_time

String

参数解释:

修改时间,使用UTC+0时间格式,格式为yyyy-MM-ddTHH:mm:ssZ。

示例:2021-01-30T23:00:00Z

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

失败响应

错误码

请参见错误码。

相关文档