文档

UpdateControlPlaneLog - 修改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:UpdateControlPlaneLogWrite
  • Cluster
    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
  • cs:EnableCoreControlPlaneComponentsLog

请求语法

PUT /clusters/{ClusterId}/controlplanelog

请求参数

名称类型必填描述示例值
ClusterIdstring

集群 ID。

c5b5e80b0b64a4bf6939d2d8fbbc5****
bodyobject

请求 Body 参数。

log_projectstring

控制平面组件日志对应存储的 SLS Project 名称。

默认值:k8s-log-$集群 ID。

k8s-log-c5b5e80b0b64a4bf6939d2d8fbbc5****
log_ttlstring

日志在 SLS logstore 里的数据保存时间。取值范围:1~3000,单位:天。

默认值:30 天。

30
aliuidstring

阿里云账号 ID。

162981*****
componentsarray

当前开启控制平面日志的组件列表。

string

当前开启控制平面日志的组件列表。支持的组件列表:

  • apiserver
  • ccm
  • scheduler
  • kcm
  • controlplane-events
  • vk:仅适用于 ASK 集群。
  • istio:仅适用于服务网格集群。
  • cluster-operator:仅适用于 ACK One 分布式云容器平台。
  • application-controller:仅适用于 ACK One 分布式云容器平台。 默认采集apiserverccmschedulerkcmcontrolplane-events组件的日志。
["apiserver", "ccm", "scheduler", "kcm", "controlplane-events"]

返回参数

名称类型描述示例值
object

返回体数据。

cluster_idstring

集群 ID。

cb95aa626a47740afbf6aa099b650****
request_idstring

请求 ID。

687C5BAA-D103-4993-884B-C35E4314****
task_idstring

任务 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-25OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
  • 本页导读 (1)