文档首页/ 安全云脑 SecMaster/ API参考（吉隆坡区域）/ API/ 威胁情报管理/ 更新威胁情报
更新时间：2025-07-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新威胁情报

功能介绍

更新威胁情报

调用方法

请参见如何调用API。

URI

PUT /v1/{project_id}/workspaces/{workspace_id}/soc/indicators/{indicator_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

workspace_id

是

String

工作空间ID

indicator_id

是

String

威胁情报ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户的Token

content-type

是

String

application/json;charset=UTF-8
表3 请求Body参数

参数

是否必选

参数类型

描述

data_object

否

IndicatorDataObjectDetail object

情报详情
表4 IndicatorDataObjectDetail

参数

是否必选

参数类型

描述

indicator_type

否

indicator_type object

情报类型对象

value

否

String

值，如：ip url domain等

update_time

否

String

更新时间

create_time

否

String

创建时间

environment

否

environment object

环境信息

data_source

否

data_source object

数据源信息

first_report_time

否

String

首次发生时间

is_deleted

否

Boolean

是否删除

last_report_time

否

String

最近发生时间

granular_marking

否

Integer

粒度（保密等级），由高到低：1（首次发现）、2（自产数据）、3（需购买）、4（外网直接查询）

name

否

String

名称

id

否

String

威胁情报ID

project_id

否

String

项目ID

revoked

否

Boolean

是否作废

status

否

String

状态， Open--打开，Closed--关闭, Revoked--作废

verdict

否

String

威胁度， Black--黑,White--白，Gray--灰

workspace_id

否

String

工作空间ID

confidence

否

Integer

置信度，取值范围是80-100
表5 indicator_type

参数

是否必选

参数类型

描述

indicator_type

否

String

情报类型

id

否

String

情报类型ID
表6 environment

参数

是否必选

参数类型

描述

vendor_type

否

String

环境供应商

domain_id

否

String

租户ID

region_id

否

String

区域ID

project_id

否

String

项目ID
表7 data_source

参数

是否必选

参数类型

描述

source_type

否

Integer

数据源类型，取值范围如下：1 - 云上产品 2 - 第三方产品 3 - 租户私有产品

domain_id

否

String

租户ID

project_id

否

String

项目ID

region_id

否

String

区域ID

响应参数

状态码：200

表8 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID,格式为：request_uuid-timestamp-hostname
表9 响应Body参数

参数

参数类型

描述

code

String

错误码

message

String

错误信息

data

IndicatorDetail object

情报详情信息
表10 IndicatorDetail

参数

参数类型

描述

id

String

威胁情报ID

name

String

威胁情报名称

data_object

IndicatorDataObjectDetail object

情报详情

workspace_id

String

工作空间ID

project_id

String

项目ID

dataclass_ref

DataClassRefPojo object

数据类对象信息

create_time

String

创建时间

update_time

String

更新时间
表11 IndicatorDataObjectDetail

参数

参数类型

描述

indicator_type

indicator_type object

情报类型对象

value

String

值，如：ip url domain等

update_time

String

更新时间

create_time

String

创建时间

environment

environment object

环境信息

data_source

data_source object

数据源信息

first_report_time

String

首次发生时间

is_deleted

Boolean

是否删除

last_report_time

String

最近发生时间

granular_marking

Integer

粒度（保密等级），由高到低：1（首次发现）、2（自产数据）、3（需购买）、4（外网直接查询）

name

String

名称

id

String

威胁情报ID

project_id

String

项目ID

revoked

Boolean

是否作废

status

String

状态， Open--打开，Closed--关闭, Revoked--作废

verdict

String

威胁度， Black--黑,White--白，Gray--灰

workspace_id

String

工作空间ID

confidence

Integer

置信度，取值范围是80-100
表12 indicator_type

参数

参数类型

描述

indicator_type

String

情报类型

id

String

情报类型ID
表13 environment

参数

参数类型

描述

vendor_type

String

环境供应商

domain_id

String

租户ID

region_id

String

区域ID

project_id

String

项目ID
表14 data_source

参数

参数类型

描述

source_type

Integer

数据源类型，取值范围如下：1 - 云上产品 2 - 第三方产品 3 - 租户私有产品

domain_id

String

租户ID

project_id

String

项目ID

region_id

String

区域ID
表15 DataClassRefPojo

参数

参数类型

描述

id

String

数据类ID

name

String

数据类名称

状态码：400

表16 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID,格式为：request_uuid-timestamp-hostname
表17 响应Body参数

参数

参数类型

描述

code

String

错误码

message

String

错误描述

请求示例

更新一条威胁情报，威胁情报触发标志为否，值为ip。

{
  "data_object" : {
    "indicator_type" : {
      "indicator_type" : "ipv6",
      "id" : "ac794b2dfab9fe8c0676587301a636d3"
    },
    "value" : "ip",
    "data_source" : {
      "domain_id" : "ac7438b990ef4a37b741004eb45e8bf4",
      "project_id" : "5b8bb3c888db498f9eeaf1023f7ba597",
      "region_id" : "xxx",
      "source_type" : 1
    },
    "workspace_id" : "909494e3-558e-46b6-a9eb-07a8e18ca620",
    "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "granular_marking" : 1,
    "first_report_time" : "2023-07-04T16:47:01Z+0800",
    "status" : "Open"
  }
}

响应示例

状态码：200

请求成功响应信息

{
  "code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
  "message" : "Error message",
  "data" : {
    "id" : "28f61af50fc9452aa0ed5ea25c3cc3d3",
    "name" : "威胁情报名称",
    "data_object" : {
      "indicator_type" : {
        "indicator_type" : "ipv6",
        "id" : "ac794b2dfab9fe8c0676587301a636d3"
      },
      "value" : "ip",
      "data_source" : {
        "domain_id" : "ac7438b990ef4a37b741004eb45e8bf4",
        "project_id" : "5b8bb3c888db498f9eeaf1023f7ba597",
        "region_id" : "xxx",
        "source_type" : 1
      },
      "workspace_id" : "909494e3-558e-46b6-a9eb-07a8e18ca620",
      "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
      "granular_marking" : 1,
      "first_report_time" : "2023-07-04T16:47:01Z+0800",
      "status" : "Open"
    },
    "workspace_id" : "909494e3-558e-46b6-a9eb-07a8e18ca620",
    "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "dataclass_ref" : {
      "id" : "28f61af50fc9452aa0ed5ea25c3cc3d3",
      "name" : "名称"
    },
    "create_time" : "2021-01-30T23:00:00Z+0800",
    "update_time" : "2021-01-30T23:00:00Z+0800"
  }
}

状态码

状态码

描述

200

请求成功响应信息

400

请求错误响应信息

错误码

请参见错误码。

父主题： 威胁情报管理