删除日志接入 - DeleteAccessConfig
功能介绍
删除日志接入
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
lts:accessConfig:delete
Write
accessConfig *
g:ResourceTag/<tag-key>
-
-
URI
DELETE /v3/{project_id}/lts/access-config
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参见:获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 从IAM服务获取的用户Token,获取方式请参见:获取用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| Content-Type | 是 | String | 参数解释: 用于定义消息体的格式,该字段填为:application/json;charset=utf8。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| access_config_id_list | 是 | Array of strings | 日志接入ID列表 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| result | Array of AccessConfigInfo objects | 参数解释: 日志接入配置信息列表 取值范围: 不涉及。 |
| total | Long | 参数解释: 日志接入配置信息的数量。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| access_config_id | String | 参数解释: 日志接入配置ID。 取值范围: 不涉及。 |
| access_config_name | String | 参数解释: 日志接入配置名称。 取值范围: 不涉及。 |
| access_config_type | String | 参数解释: 日志接入配置类型。 取值范围: |
| 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 | 参数解释: 是否拆分日志。 取值范围: |
| binary_collect | Boolean | 参数解释: 是否采集二进制数据。 取值范围: |
| cluster_id | String | 参数解释: CCE集群ID。 取值范围: 不涉及。 |
| encoding_format | String | 参数解释: 编码格式。 取值范围: 不涉及。 |
| incremental_collect | Boolean | 参数解释: 是否进行增量采集。 取值范围: |
| processor_type | String | 参数解释: ICAgent结构化解析类型。 取值范围: |
| 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 | 参数解释: 日志接入自建软件来源。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| paths | Array of strings | 参数解释: 采集路径。 |
| black_paths | Array of strings | 参数解释: 采集黑名单路径。 |
| format | AccessConfigFormatCreate object | 参数解释: 日志格式相关信息。 |
| windows_log_info | 参数解释: 日志接入配置Windows事件日志相关信息。 | |
| stdout | Boolean | 参数解释: 云容器引擎CCE应用日志接入时,是否开启采集容器标准输出。 取值范围: |
| stderr | Boolean | 参数解释: 云容器引擎CCE应用日志接入时,是否开启采集容器标准错误。 取值范围: |
| combine_stdout | Boolean | 参数解释: 云容器引擎CCE应用日志接入时,是否将标准输出和标准错误采集到同一个文件。 取值范围: |
| pathType | String | 参数解释: 数据源类型。仅云容器引擎CCE应用日志接入支持。 取值范围: |
| 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个。 若LabelValue为空,则容器 Label中包含LabelKey的容器都匹配;若LabelValue不为空,则容器 Label中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。 |
| excludeLabels | Map<String,String> | 参数解释: 容器Label黑名单,云容器引擎CCE应用日志接入时,可通过容器Label黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。 若LabelValue为空,则容器 Label中包含LabelKey的容器都被排除;若LabelValue不为空,则容器 Label中包含LabelKey=LabelValue的容器才会被排除;LabelKey需要全匹配,LabelValue支持正则匹配。 |
| includeEnvs | Map<String,String> | 参数解释: 环境变量白名单,云容器引擎CCE应用日志接入时,可通过环境变量白名单指定待采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。 若LabelValue为空,则环境变量中包含LabelKey的容器都匹配;若LabelValue不为空,则环境变量中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。 |
| excludeEnvs | Map<String,String> | 参数解释: 环境变量黑名单,云容器引擎CCE应用日志接入时,可通过环境变量黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。 若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个。 若LabelValue为空,则K8s Label中包含LabelKey的容器都匹配;若LabelValue不为空,则K8s Label中包含LabelKey=LabelValue的容器才匹配;LabelKey需要全匹配,LabelValue支持正则匹配。 |
| excludeK8sLabels | Map<String,String> | 参数解释: K8s Label黑名单,云容器引擎CCE应用日志接入时,可通过K8s Label黑名单排除不采集的容器,格式为LabelKey/LabelValue键值对。最多支持创建30个。 若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 | 参数解释: 是否允许多次采集。 取值范围: |
| system_fields | Array of strings | 参数解释: 系统内置字段。配置日志接入规则时,可以配置系统内置字段,上报日志后,每条日志数据的标签数据中将会有系统字段。若修改该字段,将覆盖原有配置。 |
| custom_key_value | Map<String,String> | 参数解释: 自定义键值对,格式为Key/Value键值对。配置日志接入规则时,可以配置自定义键值对规则,上报日志后,每条日志数据的标签数据中将会有用户自定义的键值对字段。最多支持创建20个。若修改该字段,将覆盖原有配置。 |
| includeLabelsLogical | String | 参数解释: 容器 Label白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。 取值范围: |
| excludeLabelsLogical | String | 参数解释: 容器 Label黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。 取值范围: |
| includeK8sLabelsLogical | String | 参数解释: K8S Label白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。 取值范围: |
| excludeK8sLabelsLogical | String | 参数解释: K8S Label黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。 取值范围: |
| includeEnvsLogical | String | 参数解释: 环境变量白名单生效逻辑,默认为OR。新增多条白名单时,支持选择AND或OR的关系,即全部满足或满足任意白名单就可以被匹配。 取值范围: |
| excludeEnvsLogical | String | 参数解释: 环境变量黑名单生效逻辑,默认为OR。新增多条黑名单时,支持选择AND或OR的关系,即全部满足或满足任意黑名单就可以被匹配。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| single | 参数解释: 单行日志,每一行日志在LTS界面中都显示为一条单独的日志数据。 | |
| multi | 参数解释: 多行日志,日志在LTS界面中多行日志显示为一条日志。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| categorys | Array of strings | 参数解释: 采集Windows事件日志类型。有以下四种类型: |
| time_offset | AccessConfigTimeOffset object | 参数解释: 首次采集时间偏移量信息,用于修正时间偏差或计算相对时间。例如设置为7天,表示从采集开始时间前7天内的日志(7天前的日志被忽略),该时间仅在首次配置采集生效,确保不会重复采集。 |
| event_level | Array of strings | 参数解释: 事件等级,根据Windows事件等级过滤采集。仅支持Windows Vista及以上的操作系统。有以下五种等级: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| offset | Long | 参数解释: 具体的偏移时间。 取值范围: |
| unit | String | 参数解释: 具体的偏移时间单位。 取值范围: |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| log_group_id | String | 参数解释: 日志组ID。 取值范围: 不涉及。 |
| log_stream_id | String | 参数解释: 日志流ID。 取值范围: 不涉及。 |
| log_group_name | String | 参数解释: 日志组名称。 取值范围: 不涉及。 |
| log_stream_name | String | 参数解释: 日志流名称。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| field_name | String | 参数解释: 示例日志解析字段。 取值范围: 不涉及。 |
| field_value | String | 参数解释: 示例日志的字段的值。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| source_key | String | 参数解释: 原始字段。日志结构化解析前,用于存放日志内容的原始字段。 取值范围: 不涉及。 |
| regex | String | 参数解释: 正则表达式。用于匹配日志的正则表达式。 取值范围: 不涉及。 |
| keys | Array of strings | 参数解释: 已提取字段名称。为提取的日志内容设置对应的字段名。 取值范围: 不涉及。 |
| multi_line_regex | String | 参数解释: 首行正则表达式。 取值范围: 不涉及。 |
| keep_source | Boolean | 参数解释: 是否上传原始日志。 取值范围: |
| keep_source_if_parse_error | Boolean | 参数解释: 是否上传解析失败日志。 取值范围: |
| split_sep | String | 参数解释: 分隔符。根据日志内容选择正确的分隔符,例如竖线(|)。 取值范围: 不涉及。 |
| split_type | 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 | 参数解释: 是否将解析后的时间设置为日志时间。 取值范围: |
| include | Map<String,String> | 参数解释: 日志过滤白名单规则,格式为Key/Value键值对。 取值范围: 不涉及。 |
| exclude | Map<String,String> | 参数解释: 日志过滤黑名单规则,格式为Key/Value键值对。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,请参见:错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 调用失败响应信息描述。 取值范围: 不涉及。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。