全部產品
Search

搜尋本產品

    Container Service for Kubernetes：UpdateControlPlaneLog - 修改ACK託管叢集控制面組件日誌配置

    文件中心

    Container Service for Kubernetes：UpdateControlPlaneLog - 修改ACK託管叢集控制面組件日誌配置

    更新時間：Apr 04, 2026

    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****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。