UpdateControlPlaneLog - 修改ACK托管集群控制面组件日志配置 - 容器服务 Kubernetes 版 ACK

ACK托管集群支持收集控制面组件日志并投递到您的SLS Log Project中。控制面组件包括Kube API Server、Kube Scheduler、Kube Controller Manager、Cloud Controller Manager等核心组件。您可以调用UpdateControlPlaneLog接口，修改控制面组件日志配置，例如日志保存时间、采集的组件等。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cs:UpdateControlPlaneLog

update

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

cs:EnableCoreControlPlaneComponentsLog

无

请求语法

PUT /clusters/{ClusterId}/controlplanelog HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
ClusterId	string	是	集群 ID。	c5b5e80b0b64a4bf6939d2d8fbbc5****

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求 Body 参数。
log_project	string	否	控制平面组件日志对应存储的 SLS Project 名称。默认值：k8s-log-$集群 ID。	k8s-log-c5b5e80b0b64a4bf6939d2d8fbbc5****
log_ttl	string	否	日志在 SLS logstore 里的数据保存时间。取值范围：1~3000，单位：天。默认值：30 天。	30
aliuid	string	否	阿里云账号 ID。	162981*****
components	array	否	当前开启控制平面日志的组件列表。
	string	否	当前开启控制平面日志的组件列表。支持的组件列表： `apiserver` `ccm` `scheduler` `kcm` `controlplane-events` `alb` `cluster-autoscaler` `ack-goatscaler` `kuberay-operator` `gatekepper`：仅适用于 ACK 托管集群（智能托管模式）。 `vk`：仅适用于 ASK 集群。 `istio`：仅适用于服务网格集群。 `cluster-operator`：仅适用于 ACK One 分布式云容器平台。 `application-controller`：仅适用于 ACK One 分布式云容器平台。控制面组件日志功能默认采集`apiserver`、 `ccm`、`scheduler`、`kcm`、`controlplane-events`、`alb`组件的日志。具体组件信息，请参见控制面组件 Logstore 说明。	[ "apiserver", "kcm", "scheduler", "ccm", "alb", "controlplane-events", "ack-goatscaler"]

UpdateControlPlaneLog 支持仅修改日志存储时间（log_ttl），如果您只在请求体中定义 log_ttl，后台会判定为仅修改存储时间。
UpdateControlPlaneLog 支持通过将 components 字段声明为空列表的方式来关闭所有控制面组件的日志。请在请求体中明确将 components 字段声明为空列表，如果不定义 components，将不会触发关闭控制面组件日志的操作。

返回参数

名称	类型	描述	示例值
	object	返回体数据。
cluster_id	string	集群 ID。	cb95aa626a47740afbf6aa099b650****
request_id	string	请求 ID。	687C5BAA-D103-4993-884B-C35E4314****
task_id	string	任务 ID。	T-5a54309c80282e39ea00****

示例

正常返回示例

JSON格式

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea00****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。