更新时间:2025-11-21 GMT+08:00
分享

获取索引信息 - ShowPipeIndex

功能介绍

获取索引信息

调用方法

请参见如何调用API

授权信息

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

URI

GET /v1/{project_id}/workspaces/{workspace_id}/siem/pipes/{pipe_id}/index

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

工作空间ID

pipe_id

String

管道ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

mapping

Map<String,KeyIndex>

索引映射信息

pipe_id

String

数据管道ID

status

String

索引状态;open 开启,closed 关闭

timestamp_field

String

时间戳字段名称

表4 KeyIndex

参数

参数类型

描述

is_chinese_exist

Boolean

是否包含中文

properties

Map<String,KeyIndex>

嵌套结构

type

String

参数解释:

字段类型

  • text 全文索引字段

  • keyword 关键字类型,适用于精确匹配

  • long 长整型

  • integer 整型

  • double 双精度浮点数

  • float 单精度浮点数

  • date 日期类型

约束限制

不涉及

取值范围:

  • text

  • keyword

  • long

  • integer

  • double

  • float

  • date

默认值

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码:200

成功

{
  "mapping" : {
    "key1" : {
      "type" : "keyword"
    },
    "key2" : {
      "properties" : {
        "key3" : {
          "is_chinese_exist" : true,
          "type" : "text"
        },
        "key4" : {
          "type" : "long"
        }
      }
    }
  },
  "pipe_id" : "b22106ba-bede-453c-8488-b60c70bd6aed",
  "status" : "open",
  "timestamp_field" : "timestamp"
}

状态码

状态码

描述

200

成功

400

错误响应

错误码

请参见错误码

相关文档