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

关闭日志备份或日志采集功能

功能介绍

该接口用于关闭集群的日志备份或日志采集功能。当集群不再使用日志备份或日志采集时,可以独立关闭日志备份功能和日志采集功能开关,节约存储成本。

接口约束

  • 关闭日志备份功能后,备份的日志数据不会自动清理,需前往OBS控制台手动清理。

  • 关闭日志采集功能后,已采集的日志数据不会立即被清空,仅当超过设置的保存周期时才会被系统删除,这之前也支持前往目标集群手动删除。

调用方法

请参见如何调用API

URI

PUT /v1.0/{project_id}/clusters/{cluster_id}/logs/close

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定关闭日志备份或日志采集的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

action

String

参数解释

配置关闭日志备份或者日志采集。

约束限制

集群只有开启了日志备份或日志采集功能,才能执行关闭操作。开启日志备份或日志采集操作请参见开启日志

取值范围

  • base_log_collect:关闭日志备份。

  • real_time_log_collect:停止日志采集。

默认取值

base_log_collect

请求参数

响应参数

状态码:200

请求已成功。

请求示例

关闭日志备份或日志采集功能。

PUT https://{Endpoint}/v1.0/{project_id}/clusters/5c77b71c-5b35-4f50-8984-76387e42451a/logs/close

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码