更新时间:2025-12-26 GMT+08:00
分享

查询模块详情 - ShowModule

功能介绍

查询模块详情

调用方法

请参见如何调用API

授权信息

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

URI

GET /v1/{project_id}/workspaces/{workspace_id}/soc/modules/{module_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间id。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

module_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

默认取值:

不涉及

响应参数

状态码:200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID,格式为:request_uuid-timestamp-hostname

表4 响应Body参数

参数

参数类型

描述

code

String

错误码

message

String

错误信息

data

ModuleDetailInfo object

模块详情

表5 ModuleDetailInfo

参数

参数类型

描述

cloud_pack_id

String

订阅包id

cloud_pack_name

String

订阅包名称

cloud_pack_version

String

订阅包版本

create_time

String

创建时间

creator_id

String

创建者ID

description

String

描述信息

en_description

String

英文描述

id

String

模块ID

module_json

String

模块相关信息,当module为指标卡片时,items中的字段id也为指标id

name

String

名称

en_name

String

英文名称

project_id

String

租户ID

workspace_id

String

工作空间ID

update_time

String

更新时间

thumbnail

String

模块缩略图

module_type

String

模块类型,tab/section

tag

String

模块标签

is_built_in

Boolean

是否为系统模块

data_query

String

数据查询方式

boa_version

String

BOA底座版本

version

String

安全云脑版本

状态码:400

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID,格式为:request_uuid-timestamp-hostname

表7 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

不涉及

message

String

参数解释:

错误描述

取值范围:

不涉及

请求示例

响应示例

状态码:200

模块列表返回信息

{
  "code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
  "message" : "Error message",
  "data" : {
    "boa_version" : "v3",
    "cloud_pack_id" : "cloud",
    "cloud_pack_name" : "cloud",
    "cloud_pack_version" : "cloud",
    "data_query" : "test",
    "description" : "system",
    "en_description" : "system",
    "id" : "fc574642-7a4d-32bb-bb6f-ddcfb74624d9",
    "is_built_in" : false,
    "module_json" : "{\"items\":[{\"dataclass_name\":\"指标\",\"case_sensitived\":false,\"cloud_pack_id\":\"\",\"cloud_pack_name\":\"\",\"cloud_pack_version\":\"\",\"is_built_in\":false,\"creatable\":null,\"create_time\":\"2022-03-15T10:39:09Z+0800\",\"creator_id\":\"\",\"creator_name\":\"\",\"default_value\":\"XXXXXXXXXXXX\",\"en_default_value\":\"\",\"description\":\"\",\"en_description\":\"\",\"display_type\":\"pie\",\"editable\":null,\"extra_json\":\"{\"x-label\":\"time\",\"y-label\":\"value\",\"api\":\"/xxxx/\"}\",\"field_key\":\"XXXXXXX\",\"name\":\"XXXXXX\",\"en_name\":\"\",\"field_tooltip\":\"\",\"field_type\":\"pie\",\"id\":\"21d729b8-2fa4-4e61-82ef-c7fa4bff02ef\",\"iu_type\":null,\"json_schema\":\"\",\"maintainable\":null,\"modifier_id\":\"\",\"modifier_name\":\"\",\"readonly\":false,\"required\":false,\"searchable\":false,\"update_time\":\"2022-03-15T10:39:09Z+0800\",\"used_by\":\"securityreport\",\"visible\":true}]}",
    "module_type" : "section",
    "name" : "module",
    "project_id" : "25895222e8744afa985c93dab6341da6",
    "workspace_id" : "7e0f8248-5799-465e-9d94-9ff07f4b800d"
  }
}

状态码

状态码

描述

200

模块列表返回信息

400

错误响应

错误码

请参见错误码

相关文档