更新时间:2026-01-05 GMT+08:00

创建结构化配置(推荐)

功能介绍

该接口通过结构化模板创建结构化配置,便于参数提取且简化参数结构,推荐您使用。

单个用户每秒仅能调用1次该接口。

URI

POST /v3/{project_id}/lts/struct/template

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID

最小长度:32

最大长度:32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token,获取方式请参见:获取用户Token

最小长度:1000

最大长度:2000

Content-Type

String

该字段填为:application/json;charset=UTF-8。

最小长度:30

最大长度:30

表3 请求Body参数

参数

是否必选

参数类型

描述

log_group_id

String

日志组id,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID

最小长度:36

最大长度:36

log_stream_id

String

日志流id,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID

最小长度:36

最大长度:36

template_name

String

所用模板名称,会对模板名称进行校验,不能为空

最小长度:1

最大长度:64

template_type

String

所用模板类型,分为built_in及custom两种类型,对应系统模板和自定义模板, 详细系统模板类型参考:“用户指南-日志搜索与分析 > 设置云端结构化解析日志 > 设置云端结构化模板”章节。

template_id

String

创建或修改结构化时所使用的自定义结构化模板id。当使用系统模板时,当前属性可以为空。可从查询自定义结构化模板接口中获取。

响应参数

状态码:201

请求响应成功。

状态码:400

表4 响应Body参数

参数

参数类型

描述

errorCode

String

响应错误码。

errorMessage

String

响应错误内容。

isQueryComplete

Boolean

是否完成查询。

queryComplete

Boolean

是否完成查询。

remainIterationCount

Integer

剩余迭代次数。

请求示例

  • 创建ELB系统模板

    POST https://{endpoint}/v3/{project_id}/lts/struct/template
    
    {
      "log_group_id" : "17f23e52-a23d-46e0-8bc5-xxxxxxxxxxxx",
      "log_stream_id" : "b4d56d47-b4c4-453e-9047-xxxxxxxxxxxx",
      "template_type" : "built_in",
      "template_name" : "ELB",
      "template_id" : ""
    }
  • 创建VPC系统模板

    POST https://{endpoint}/v3/{project_id}/lts/struct/template
    
    {
      "log_group_id" : "17f23e52-a23d-46e0-8bc5-xxxxxxxxxxxx",
      "log_stream_id" : "b4d56d47-b4c4-453e-9047-xxxxxxxxxxxx",
      "template_type" : "built_in",
      "template_name" : "VPC",
      "template_id" : ""
    }

响应示例

状态码:201

请求响应成功。

 none

状态码:400

BadRequest 非法请求 建议根据errorMessage直接修改该请求。

{
  "errorCode" : "SVCSTG.ALS.200201",
  "errorMessage" : "built_in template's is not exists",
  "isQueryComplete" : true,
  "queryComplete" : true,
  "remainIterationCount" : 0
}

状态码

状态码

描述

201

请求响应成功。

400

BadRequest 非法请求 建议根据errorMessage直接修改该请求。

错误码

请参见错误码