采集规则分页列表
更新时间 2025-09-16 19:00:47
最近更新时间: 2025-09-16 19:00:47
接口功能介绍
获取采集规则分页列表
接口约束
无
URI
GET /v1/collectorRule/page
路径参数 无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
unitCode | 是 | String | 单元ID,可从单元列表获取 | d0512b90e44992 | |
ruleCode | 否 | String | 采集规则编码,可从采集规则列表获取 | 776a7b1c2845a1 | |
ruleName | 否 | String | 可根据采集规则名称和原始名称模糊匹配 | test-rule | |
pageNum | 是 | Integer | 页码 | 1 | |
pageSize | 是 | Integer | 每页记录数 | 10 |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionId | 是 | String | 资源池编码,请参考资源池列表 | 20000000***1852 |
请求体body参数 无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 响应状态码。0:代表正常;-1:代表严重错误;-2:代表普通错误 | 0 | |
error | String | 业务错误码,仅错误时返回,例LTS_XXXX | LTS_0001 | |
message | String | 请求响应信息 | 成功 | |
requestId | String | 请求ID | 3e31ebb2-572e5408e | |
returnObj | Object | 规则分页列表 | data | |
表 data |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
unitCode | String | 单元ID | 1b7cd64377bd7 | |
ruleName | String | 采集规则原始名称 | lmtagent | |
ruleCode | String | 采集规则编码 | d9b051ed09467de2 | |
extractMode | Byte | 采集类型,1:云主机-文本日志;2:云容器引擎-标准输出;3:云容器引擎-文本日志;4:syslog-协议; 5: 物理机-文本日志 | 1 | |
logPaths | Array of Strings | 采集路径 | ["/app"] | |
cuttingMode | String | 切割模式,不同模式对应其他参数不同。1:单行正则;2:分隔符;3:多行正则;4:单行全文;5:json;6:多行全文 | 4 | |
ruleConfig | Object | 采集规则高级配置 | RuleConfig | |
accessType | Byte | 接入类型。1:ccse;2:msap;3:csm;4:faas;5:msegw;6:ctgcache;7:kafka;8:mq2;9:amqp;10:host;11:mqtt;12:ebm;13:rcc | 10 | |
createTime | String | 创建时间 | 2024-08-23 15:55:07 | |
collectPolicy | String | 采集策略。all:全量采集;add:增量采集 | all | |
表 RuleConfig |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
maxPathDepth | Integer | 当采集路径中带""通配符时,该参数用于指定""通配符最大解析深度 | 5 | |
excludeFilePaths | Array of Strings | 文件路径黑名单(排除文件路径符合条件的文件;必须为绝对路径) | ["/app/cams/lmtagent/test/out.log"] | |
excludeFiles | Array of Strings | 文件黑名单(排除文件名符合条件的文件;必须为文件名,不包含路径) | ["info.log"] | |
excludeDirs | Array of Strings | 目录黑名单(排除文件所在目录符合条件的文件;必须为绝对路径) | ["/app/cams/lmtagent/access"] | |
delimiter | Object | 分隔符,当切割模式为分隔符时返回 | DelimiterObj | |
regex | String | 正则切割模式:当切割模式为正则时返回 | RegexObj | |
表 DelimiterObj |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
delimiter | String | 分隔符 | ||
logContent | Array of Objects | 分割所得类型字段,输入顺序会被使用 | DelimiterLogContent | |
表 RegexObj |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
regexStr | String | 正则表达式 | ^\[\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\] | |
logContent | Array of Objects | 分割所得类型字段,输入顺序会被使用 | RegexLogContent | |
表 DelimiterLogContent |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
key | String | 提取字段 | time | |
type | String | 数据类型。text:字符串;double:数字 | text | |
表 RegexLogContent |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
key | String | 提取字段 | time | |
type | String | 数据类型。text:字符串;double:数字 | text |
枚举参数
无
请求示例
请求url
GET https://[endpoint]/v1/hostGroup/ecsPageList/v1/collectorRule/page?unitCode=d0512b90e44992&pageNum=1&pageSize=10
请求头header
regionId:20000000***1852
请求体body
无
响应示例
{
"statusCode": 0,
"requestId": "de71ecda-f722a65cb",
"error": null,
"message": null,
"returnObj": {
"total": 1,
"list": [
{
"unitCode": "1b7cd64377bd75",
"ruleName": "lmtagent-plugin",
"ruleCode": "d9b051ed09467de2",
"extractMode": 1,
"logPaths": [
"/app/cams/lmtagent/*.LOG"
],
"cuttingMode": "4",
"ruleConfig": {
"maxPathDepth": 5,
"delimiter": {
},
"regex": {
},
"logFilterVo": {
"include": {
},
"exclude": {
}
}
},
"accessType": 10,
"createTime": "2024-08-23 15:55:07",
"collectPolicy": "add"
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码