文档首页/ 云日志服务 LTS/ API参考/ API说明/ 日志接入/ 删除日志接入 - DeleteAccessConfig
更新时间:2026-09-11 GMT+08:00
分享

删除日志接入 - DeleteAccessConfig

功能介绍

删除日志接入

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    lts:accessConfig:delete

    Write

    accessConfig *

    g:ResourceTag/<tag-key>

    -

    -

URI

DELETE /v3/{project_id}/lts/access-config

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参见:获取项目ID

约束限制:

不涉及。

取值范围:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

String

参数解释:

用于定义消息体的格式,该字段填为:application/json;charset=utf8。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

access_config_id_list

Array of strings

日志接入ID列表

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

result

Array of AccessConfigInfo objects

参数解释:

日志接入配置信息列表

取值范围:

不涉及。

total

Long

参数解释:

日志接入配置信息的数量。

取值范围:

不涉及。

表5 AccessConfigInfo

参数

参数类型

描述

access_config_id

String

参数解释:

日志接入配置ID。

取值范围:

不涉及。

access_config_name

String

参数解释:

日志接入配置名称。

取值范围:

不涉及。

access_config_type

String

参数解释:

日志接入配置类型。

取值范围:

  • AGENT:云主机ECS文本日志接入。

  • K8S_CCE:云容器引擎CCE应用日志接入。

create_time

Long

参数解释:

日志接入配置的创建时间。

取值范围:

不涉及。

access_config_detail

AccessConfigDeatilCreate object

参数解释:

日志接入配置的详细信息。

log_info

AccessConfigQueryLogInfo object

参数解释:

日志接入配置的日志流详情。

host_group_info

AccessConfigHostGroupIdList object

参数解释:

日志接入配置的主机组ID列表。

access_config_tag

Array of accessConfigTagResp objects

参数解释:

日志接入配置的标签信息。

log_split

Boolean

参数解释:

是否拆分日志。

取值范围:

  • true:进行日志拆分。

  • false:不进行日志拆分。

binary_collect

Boolean

参数解释:

是否采集二进制数据。

取值范围:

  • true:采集二进制数据。

  • false:不采集二进制数据。

cluster_id

String

参数解释:

CCE集群ID。

取值范围:

不涉及。

encoding_format

String

参数解释:

编码格式。

取值范围:

不涉及。

incremental_collect

Boolean

参数解释:

是否进行增量采集。

取值范围:

  • true:采集新增日志数据。

  • false:采集全量日志数据。

processor_type

String

参数解释:

ICAgent结构化解析类型。

取值范围:

  • SINGLE_LINE:单行全文

  • MULTI_LINE:多行全文

  • REGEX:单行正则

  • MULTI_REGEX:多行正则

  • SPLIT:分隔符

  • JSON:json解析

  • NGINX:NGINX解析

  • COMPOSE:

  • ORC:orc格式

demo_log

String

参数解释:

示例日志。

取值范围:

不涉及。

demo_fields

Array of DemoFieldAccess objects

参数解释:

示例日志解析字段。

processors

Array of Processor objects

参数解释:

ICAgent结构化解析器。

log_split_size

Integer

参数解释:

拆分日志大小。

取值范围:

不涉及。

application_id

String

参数解释:

ServiceStage应用ID。

取值范围:

不涉及。

environment_id

String

参数解释:

ServiceStage环境ID。

取值范围:

不涉及。

component_id

Array of strings

参数解释:

ServiceStage组件ID列表。

recursive_depth

Integer

参数解释:

采集路径递归最大深度。

取值范围:

不涉及。

access_config_type_source

String

参数解释:

日志接入自建软件来源。

取值范围:

  • ECS

  • CCE

  • BMS

  • K8S

  • ServiceStageHost

  • ServiceStage

表6 AccessConfigDeatilCreate

参数

参数类型

描述

paths

Array of strings

参数解释:

采集路径。

  • 路径必须以/或者字母:\开头。

  • 不能包含特殊字符<> ' | " 且不能只输入/。

  • 第一级目录不支持通配符*:不能以/** /*开头。

  • **只能出现一次``

  • CCE类型中容器路径和主机路径必填,标准输出不用。

black_paths

Array of strings

参数解释:

采集黑名单路径。

  • 路径必须以/或者字母:\开头

  • 不能包含特殊字符<> ' | " 且不能只输入/

  • 第一级目录不支持通配符*:不能以/** /*开头

  • **只能出现一次

format

AccessConfigFormatCreate object

参数解释:

日志格式相关信息。

windows_log_info

AccessConfigWindowsLogInfoCreate object

参数解释:

日志接入配置Windows事件日志相关信息。

stdout

Boolean

参数解释:

云容器引擎CCE应用日志接入时,是否开启采集容器标准输出。

取值范围:

  • true:开启采集容器标准输出。

  • false:不开启采集容器标准输出。

stderr

Boolean

参数解释:

云容器引擎CCE应用日志接入时,是否开启采集容器标准错误。

取值范围:

  • true:开启采集容器标准错误。

  • false:不开启采集容器标准错误。

combine_stdout

Boolean

参数解释:

云容器引擎CCE应用日志接入时,是否将标准输出和标准错误采集到同一个文件。

取值范围:

  • true:将标准输出和标准错误采集到同一个文件(stdout.log)。

  • false:将标准输出和标准错误采集到不同的文件(stdout.log和stderr.log)。

pathType

String

参数解释:

数据源类型。仅云容器引擎CCE应用日志接入支持。

取值范围:

  • HOST_FILE:节点文件类型

  • CONTAINER_STDOUT:容器标准输出

  • CONTAINER_FILE:容器文件路径

  • K8S_EVENT:K8S事件

namespaceRegex

String

参数解释:

K8s Namespace正则匹配。通过Namespace名称指定采集的容器,支持正则匹配。采集名称符合正则规则的Namespace的日志,为空时采集所有Namespace的日志。

仅云容器引擎CCE应用日志接入支持。

取值范围:

不涉及。

podNameRegex

String

参数解释:

K8s Pod正则匹配。通过Pod名称指定待采集的容器,支持正则匹配。采集名称符合正则规则的Pod的日志,为空时采集所有Pod的日志。

仅云容器引擎CCE应用日志接入支持。

取值范围:

不涉及。

containerNameRegex

String

参数解释:

K8s容器名称正则匹配。通过容器名称指定待采集的容器(Kubernetes容器名称是定义在spec.containers中),支持正则匹配。采集名称符合正则规则的容器的日志,为空时采集所有容器的日志。

仅云容器引擎CCE应用日志接入支持。

取值范围:

不涉及。

includeLabels

Map<String,String>

参数解释:

容器Label白名单,云容器引擎CCE应用日志接入时,可通过容器Label白名单指定待采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则容器 Label中包含LabelKey的容器都匹配;若LabelValue不为空,则容器 Label中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。

excludeLabels

Map<String,String>

参数解释:

容器Label黑名单,云容器引擎CCE应用日志接入时,可通过容器Label黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则容器 Label中包含LabelKey的容器都被排除;若LabelValue不为空,则容器 Label中包含LabelKey=LabelValue的容器才会被排除;LabelKey需要全匹配,LabelValue支持正则匹配。

includeEnvs

Map<String,String>

参数解释:

环境变量白名单,云容器引擎CCE应用日志接入时,可通过环境变量白名单指定待采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则环境变量中包含LabelKey的容器都匹配;若LabelValue不为空,则环境变量中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。

excludeEnvs

Map<String,String>

参数解释:

环境变量黑名单,云容器引擎CCE应用日志接入时,可通过环境变量黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则环境变量中包含LabelKey的容器都被排除;若LabelValue不为空,则环境变量中包含LabelKey=LabelValue的容器才会被排除;LabelKey需要全匹配,LabelValue支持正则匹配。

logLabels

Map<String,String>

参数解释:

容器 Label日志标签,云容器引擎CCE应用日志接入时,可通过该参数在日志中新增容器Label相关字段。例如:设置LabelKey为app,设置LabelValue为app_alias,当容器中包含app=lts时,将在日志中添加内容{app_alias:lts}。

logEnvs

Map<String,String>

参数解释:

环境变量日志标签,云容器引擎CCE应用日志接入时,可通过该参数在日志中新增环境变量相关字段。例如:设置环境变量Key为app,设置环境变量Value为app_alias,当K8S中包含环境变量app=lts时,将在日志中添加的内容为{app_alias:lts}。

includeK8sLabels

Map<String,String>

参数解释:

K8s Label白名单,云容器引擎CCE应用日志接入时,可通过K8s Label白名单指定待采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则K8s Label中包含LabelKey的容器都匹配;若LabelValue不为空,则K8s Label中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。

excludeK8sLabels

Map<String,String>

参数解释:

K8s Label黑名单,云容器引擎CCE应用日志接入时,可通过K8s Label黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。

  • LabelKey:必填项,不能以小数点开头,长度不能超过128个字符。

  • LabelValue:可以为空,长度不能超过512个字符。

若LabelValue为空,则K8s Label中包含LabelKey的容器都被排除;若LabelValue不为空,则K8s Label中包含LabelKey=LabelValue的容器才会被排除;LabelKey需要全匹配,LabelValue支持正则匹配。

logK8s

Map<String,String>

参数解释:

K8s Label日志标签,云容器引擎CCE应用日志接入时,可通过该参数在日志中新增K8s Label相关字段。例如:设置LabelKey为app,设置LabelValue为app_alias,当容器中包含app=lts时,将在日志中添加内容{app_alias:lts}。

repeat_collect

Boolean

参数解释:

是否允许多次采集。

取值范围:

  • true:表示开启,同一主机下的同一日志文件支持被采集到多个日志流。

  • false:表示关闭,采集路径不能重复配置,即同一主机下的同一日志文件,即使跨日志流,也只能配置一次。

system_fields

Array of strings

参数解释:

系统内置字段。配置日志接入规则时,可以配置系统内置字段,上报日志后,每条日志数据的标签数据中将会有系统字段。若修改该字段,将覆盖原有配置。

  • 采集场景为主机文件的内置字段为:hostName、hostId、hostIP、pathFile、hostIPv6、category、collectTime、__host_group__

  • 采集场景为K8S集群容器文件的内置字段为:hostName、hostId、hostIP、pathFile、hostIPv6、clusterId、podName、appName、containerName、nameSpace、category、collectTime、__host_group__、serviceID、podIp、clusterName、workloadType、__image_name__

custom_key_value

Map<String,String>

参数解释:

自定义键值对,格式为Key/Value键值对。配置日志接入规则时,可以配置自定义键值对规则,上报日志后,每条日志数据的标签数据中将会有用户自定义的键值对字段。最多支持创建20个。若修改该字段,将覆盖原有配置。

  • Key:允许的字符有a-zA-Z0-9_-,长度不能超过128个字符。

  • Value:长度不能超过1024个字符。

includeLabelsLogical

String

参数解释:

容器 Label白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。

取值范围:

  • AND

  • OR

excludeLabelsLogical

String

参数解释:

容器 Label黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。

取值范围:

  • AND

  • OR

includeK8sLabelsLogical

String

参数解释:

K8S Label白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。

取值范围:

  • AND

  • OR

excludeK8sLabelsLogical

String

参数解释:

K8S Label黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。

取值范围:

  • AND

  • OR

includeEnvsLogical

String

参数解释:

环境变量白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。

取值范围:

  • AND

  • OR

excludeEnvsLogical

String

参数解释:

环境变量黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。

取值范围:

  • AND

  • OR

表7 AccessConfigFormatCreate

参数

参数类型

描述

single

AccessConfigFormatSingleCreate object

参数解释:

单行日志,每一行日志在LTS界面中都显示为一条单独的日志数据。

multi

AccessConfigFormatMutilCreate object

参数解释:

多行日志,日志在LTS界面中多行日志显示为一条日志。

表8 AccessConfigFormatSingleCreate

参数

参数类型

描述

mode

String

参数解释:

单行日志采集模式。

取值范围:

  • system:系统时间。

  • wildcard:时间通配符。

value

String

参数解释:

日志时间。

  • 当mode为“system”时 ,value填入当前时间戳。

  • 当mode为“wildcard”时,value填入时间通配符。通过时间通配符匹配日志,每条日志的行首显示日志的打印时间,如果日志中的时间格式为2019-01-01 23:59:59,则时间通配符应该填写为YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为19-1-1 23:59:59,则时间通配符应该填写为YY-M-D hh:mm:ss。

取值范围:

不涉及。

表9 AccessConfigFormatMutilCreate

参数

参数类型

描述

mode

String

参数解释:

多行日志采集模式。

取值范围:

  • time:日志时间。

  • regular:正则模式。

value

String

参数解释:

日志时间。

  • 当mode为“system”时 ,value填入当前时间戳。

  • 当mode为“wildcard”时,value填入时间通配符。通过时间通配符匹配日志,每条日志的行首显示日志的打印时间,如果日志中的时间格式为2019-01-01 23:59:59,则时间通配符应该填写为YYYY-MM-DD hh:mm:ss;如果日志中的时间格式为19-1-1 23:59:59,则时间通配符应该填写为YY-M-D hh:mm:ss。

取值范围:

不涉及。

表10 AccessConfigWindowsLogInfoCreate

参数

参数类型

描述

categorys

Array of strings

参数解释:

采集Windows事件日志类型。有以下四种类型:

  • Application:应用系统。

  • System:系统。

  • Security:安全。

  • Setup:启动。

time_offset

AccessConfigTimeOffset object

参数解释:

首次采集时间偏移量信息,用于修正时间偏差或计算相对时间。例如设置为7天,表示从采集开始时间前7天内的日志(7天前的日志被忽略),该时间仅在首次配置采集生效,确保不会重复采集。

event_level

Array of strings

参数解释:

事件等级,根据Windows事件等级过滤采集。仅支持Windows Vista及以上的操作系统。有以下五种等级:

  • information:提示。

  • warning:告警。

  • error:错误。

  • critical:关键。

  • verbose:冗长。

表11 AccessConfigTimeOffset

参数

参数类型

描述

offset

Long

参数解释:

具体的偏移时间。

取值范围:

  • 当"unit"选择"day"时,offset取值范围为1~7天。

  • 当"unit"选择"hour"时,offset取值范围为1~168小时。

  • 当"unit"选择"sec"时,offset取值范围为1~604800秒。

unit

String

参数解释:

具体的偏移时间单位。

取值范围:

  • day:天。

  • hour:小时。

  • sec:秒。

表12 AccessConfigQueryLogInfo

参数

参数类型

描述

log_group_id

String

参数解释:

日志组ID。

取值范围:

不涉及。

log_stream_id

String

参数解释:

日志流ID。

取值范围:

不涉及。

log_group_name

String

参数解释:

日志组名称。

取值范围:

不涉及。

log_stream_name

String

参数解释:

日志流名称。

取值范围:

不涉及。

表13 AccessConfigHostGroupIdList

参数

参数类型

描述

host_group_id_list

Array of strings

参数解释:

主机组ID列表。

表14 accessConfigTagResp

参数

参数类型

描述

key

String

参数解释:

标签键。

取值范围:

  • 标签键可以包含任意语种的字母、数字和空格,以及_.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头。

  • 标签键长度不能超过128个字符。

value

String

参数解释:

标签值。

取值范围:

  • 标签值可以包含任意语种的字母、数字和空格,以及_.:=+-@字符。

  • 标签值长度不能超过255个字符。

表15 DemoFieldAccess

参数

参数类型

描述

field_name

String

参数解释:

示例日志解析字段。

取值范围:

不涉及。

field_value

String

参数解释:

示例日志的字段的值。

取值范围:

不涉及。

表16 Processor

参数

参数类型

描述

type

String

参数解释:

结构化解析类型。

取值范围:

  • processor_regex:正则解析。

  • processor_split_string:分词符。

  • processor_json:json解析类型。

  • processor_gotime:自定义时间类型。

  • processor_filter_regex:日志过滤。

  • processor_drop:删除字段类型。

  • processor_rename:修改字段类型。

detail

Detail object

参数解释:

结构化解析配置的相关信息。

表17 Detail

参数

参数类型

描述

source_key

String

参数解释:

原始字段。日志结构化解析前,用于存放日志内容的原始字段。

取值范围:

不涉及。

regex

String

参数解释:

正则表达式。用于匹配日志的正则表达式。

取值范围:

不涉及。

keys

Array of strings

参数解释:

已提取字段名称。为提取的日志内容设置对应的字段名。

取值范围:

不涉及。

multi_line_regex

String

参数解释:

首行正则表达式。

取值范围:

不涉及。

keep_source

Boolean

参数解释:

是否上传原始日志。

取值范围:

  • true:保留原始日志。

  • false:不保留原始日志。

keep_source_if_parse_error

Boolean

参数解释:

是否上传解析失败日志。

取值范围:

  • true:上传解析失败日志。

  • false:不上传解析失败日志。

split_sep

String

参数解释:

分隔符。根据日志内容选择正确的分隔符,例如竖线(|)。

取值范围:

不涉及。

split_type

String

参数解释:

分隔类型。

取值范围:

  • char:单字符。

  • special_char:不可见字符。

  • string:字符串。

fields

Map<String,String>

参数解释:

待添加的字段名和字段值,格式为Key/Value键值对。支持添加多个。

取值范围:

不涉及。

drop_keys

Array of strings

参数解释:

丢弃的字段列表。

取值范围:

不涉及。

source_keys

Array of strings

参数解释:

待重命名的原始字段。

取值范围:

不涉及。

dest_keys

Array of strings

参数解释:

重命名后的字段。

取值范围:

不涉及。

expand_depth

Integer

参数解释:

json展开的深度。1表示当前层级,以此类推。

取值范围:

1-10。

expand_connector

String

参数解释:

json展开时的连接符。

取值范围:

不涉及。

source_format

String

参数解释:

原始时间的格式。

取值范围:

不涉及。

source_value

String

参数解释:

原始时间字段value。

取值范围:

不涉及。

set_time

Boolean

参数解释:

是否将解析后的时间设置为日志时间。

取值范围:

  • true:将解析后的时间设置为日志时间。

  • false:不将解析后的时间设置为日志时间。

include

Map<String,String>

参数解释:

日志过滤白名单规则,格式为Key/Value键值对。

取值范围:

不涉及。

exclude

Map<String,String>

参数解释:

日志过滤黑名单规则,格式为Key/Value键值对。

取值范围:

不涉及。

状态码:400

表18 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,请参见:错误码

取值范围:

不涉及。

error_msg

String

参数解释:

调用失败响应信息描述。

取值范围:

不涉及。

状态码:500

表19 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,请参见:错误码

取值范围:

不涉及。

error_msg

String

参数解释:

调用失败响应信息描述。

取值范围:

不涉及。

请求示例

删除日志接入。

DELETE https://{endpoint}/v3/{project_id}/lts/access-config

/v3/{project_id}/lts/access-config  
{"access_config_id_list":["xxxx","xxxx"]}

响应示例

状态码:200

删除日志接入请求响应成功

{
  "result" : [ {
    "access_config_detail" : {
      "black_paths" : [ "/wjy/hei/tesxxx", "/wjy/hei/tesxxx" ],
      "format" : {
        "single" : {
          "mode" : "wildcard",
          "value" : "1111"
        }
      },
      "paths" : [ "/wjy/tesxxx", "/wjy/texxx", "/wjyxxxxx" ],
      "windows_log_info" : {
        "categorys" : [ "System", "Application", "Security", "Setup" ],
        "event_level" : [ "information", "warning", "error", "critical", "verbose" ],
        "time_offset" : {
          "offset" : 168,
          "unit" : "hour"
        }
      }
    },
    "access_config_id" : "aa58d29e-21a9-4761-ba16-8xxxxx",
    "access_config_name" : "采集Wjyxxxxxt2",
    "access_config_tag" : [ {
      "key" : "xxx",
      "value" : "xxx"
    }, {
      "key" : "xxx1",
      "value" : "xxx1"
    } ],
    "access_config_type" : "AGENT",
    "create_time" : 1635043645628,
    "host_group_info" : {
      "host_group_id_list" : [ "de4dbed4-a3bc-4877-a7ee-0xxxxxx6" ]
    },
    "log_info" : {
      "log_group_id" : "9a7e2183-2d6d-4732-9a9b-e89xxxxx0",
      "log_group_name" : "lts-groupxxxxxka",
      "log_stream_id" : "c4de0538-53e6-41fd-b951-a8xxxxx58d7",
      "log_stream_name" : "lts-topic-txxxxx"
    }
  } ],
  "total" : 1
}

状态码:400

非法请求,建议根据error_msg直接修改该请求。

{
  "error_code" : "LTS.1807",
  "error_msg" : "Invalid access config id"
}

状态码:500

表明服务端能被请求访问到,但是服务内部出错。

{
  "error_code" : "LTS.0010",
  "error_msg" : "The system encountered an internal error"
}

状态码

状态码

描述

200

删除日志接入请求响应成功

400

非法请求,建议根据error_msg直接修改该请求。

500

表明服务端能被请求访问到,但是服务内部出错。

错误码

请参见错误码

相关文档