UpdateControlPlaneLog - 修改ACK托管集群控制面组件日志配置_容器服务 Kubernetes 版 ACK(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		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` `vk`：仅适用于 ASK 集群。 `istio`：仅适用于服务网格集群。 `cluster-operator`：仅适用于 ACK One 分布式云容器平台。 `application-controller`：仅适用于 ACK One 分布式云容器平台。默认采集`apiserver`、 `ccm`、`scheduler`、`kcm`、`controlplane-events`组件的日志。	["apiserver", "ccm", "scheduler", "kcm", "controlplane-events"]

返回参数

名称	类型	描述	示例值
	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****"
}

示例

正常返回示例

JSON格式

{
	"cluster_id": "c5b5e80b0b64a4bf6939d2d8fbbc5****",
	"request_id": "A0322123-8DE3-199A-913D-6CBC0F4C****",
	"task_id": "T-65840b469fc9d303b000****"
}

示例

正常返回示例

JSON格式

{
	"cluster_id": "c5b5e80b0b64a4bf6939d2d8fbbc5****",
	"request_id": "A0322123-8DE3-199A-913D-6CBC0F4C****",
	"task_id": "T-65840b469fc9d303b000****"
}

示例

正常返回示例

JSON格式

{
	"cluster_id": "c5b5e80b0b64a4bf6939d2d8fbbc5****",
	"request_id": "A0322123-8DE3-199A-913D-6CBC0F4C****",
	"task_id": "T-65840b469fc9d303b000****"
}

示例

正常返回示例

JSON格式

{
	"cluster_id": "c5b5e80b0b64a4bf6939d2d8fbbc5****",
	"request_id": "A0322123-8DE3-199A-913D-6CBC0F4C****",
	"task_id": "T-65840b469fc9d303b000****"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2023-12-25	OpenAPI 返回结构发生变更	查看变更详情