全部產品
Search
文件中心

:API概覽

更新時間:Mar 17, 2026

Container ServiceKubernetes版提供以下API介面。

重要

在使用API管理Kubernetes叢集前,請確保您已閱讀和同意使用須知及高危風險操作說明

叢集

API

描述

建立Kubernetes專有版叢集

調用CreateCluster建立一個標準Kubernetes專有版叢集。

建立Kubernetes託管版叢集

調用CreateCluster建立一個新的Managed Kubernetes叢集執行個體,並建立指定數量的節點。

建立ACK Serverless叢集

調用CreateCluster建立一個新的ACK Serverless叢集執行個體。

建立ACK Edge叢集

調用CreateCluster建立一個新的ACK Edge叢集執行個體。

建立專有版安全沙箱Kubernetes叢集

調用CreateCluster建立一個專有版安全沙箱Kubernetes叢集。

建立基礎託管版安全沙箱Kubernetes叢集

調用CreateCluster建立一個託管版安全沙箱Kubernetes叢集。

查詢所有叢集列表

調用DescribeClustersV1查看您在ACK中建立的所有叢集(包括Swarm和Kubernetes叢集)。

查詢叢集資訊

調用DescribeClusterDetail,根據叢集ID,查看叢集的詳細資料。

查詢叢集資源

調用DescribeClusterResources查詢指定叢集的所有資源。

查詢叢集代理

調用DescribeExternalAgent查詢額外代理。

查詢叢集日誌

調用DescribeClusterLogs查詢指定叢集日誌。

查詢叢集節點

調用DescribeClusterNodes查詢叢集節點。

查詢任務詳情

調用DescribeTaskInfo根據任務ID查詢任務執行詳情。

擷取叢集KubeConfig介面

調用DescribeClusterUserKubeconfig返回包含當前登入使用者身份資訊的Kubernetes叢集訪問kubeconfig。

查詢Kubernetes版本詳情

調用DescribeKubernetesVersionMetadata查詢支援的Kubernetes版本的詳細資料。

查詢使用者配額

調用DescribeUserQuota查詢使用者配額。

查詢使用者事件

調用DescribeEvents查詢使用者操作事件。

添加已有ENS節點至Kubernetes邊緣託管叢集

調用AttachInstances介面添加已有ENS節點至ACK Edge叢集

修改叢集

調用ModifyCluster修改叢集。

遷移叢集

調用MigrateCluster將叢集從標準託管版遷移至Pro託管版。

刪除叢集

調用DeleteCluster根據叢集ID,刪除叢集執行個體,並釋放叢集所有節點資源。

建立自動調整配置

調用CreateAutoscalingConfig建立自動調整配置。

許可權

API

描述

查詢RAM使用者或RAM角色叢集授權資訊

調用DescribeUserPermission查詢指定RAM使用者的叢集授權資訊。

全量更新RAM使用者或RAM角色叢集授權資訊

調用GrantPermissions全量更新RAM使用者叢集授權資訊。

更新使用者KubeConfig認證預設到期時間

調用UpdateK8sClusterUserConfigExpire更新使用者認證到期時間。

節點池

API

描述

建立節點池

調用CreateClusterNodePool為叢集建立節點池。

擴縮容節點池

調用ModifyClusterNodePool擴縮容節點池節點。

修改節點池配置

調用ModifyClusterNodePool更新節點配置。

查詢節點池列表

調用DescribeClusterNodePools查詢叢集內所有節點池詳情。

查詢節點池詳情

調用DescribeClusterNodePoolDetail查詢叢集指定節點池詳情。

添加已有執行個體至節點池

調用AttachInstances添加已有執行個體到叢集。

手動添加已有執行個體至節點池

調用DescribeClusterAttachScripts添加已有節點到ACK Edge叢集。該API返回唯一的可執行指令碼,您擷取指令碼後,在已有節點上執行即可完成該節點的接入。

修複節點池節點

調用RepairClusterNodePool修複指定的託管節點池內指定節點存在的問題。

移除節點池節點

調用RemoveNodePoolNodes移除指定叢集額外節點。

刪除節點池

調用DeleteClusterNodepool刪除節點池。

升級

API

描述

升級叢集

調用UpgradeCluster升級指定使用者叢集。

查詢叢集升級狀態

調用GetUpgradeStatus查詢叢集升級狀態。

暫停叢集升級

調用PauseClusterUpgrade暫停使用者叢集升級。

取消叢集升級

調用CancelClusterUpgrade取消叢集升級。

恢複叢集升級

調用ResumeUpgradeCluster重新開始暫停叢集的升級。

應用

API

描述

建立編排模板

調用CreateTemplate建立一個模板。

查詢所有編排模板

調用DescribeTemplates查詢編排模板。

查詢編排模板詳情

調用DescribeTemplateAttribute查看指定模板的詳細資料。

更新編排模板

調用UpdateTemplate更新一個編排模板。

刪除編排模板

調用DeleteTemplate刪除指定模板。

建立觸發器

調用CreateTrigger為應用建立觸發器。

查詢觸發器

調用DescribeTrigger查詢指定應用觸發器。

刪除觸發器

調用DeleteTrigger刪除應用觸發器。

組件

API

描述

安裝叢集組件

調用InstallClusterAddons為指定叢集安裝組件。

查詢叢集組件詳情

調用DescribeAddons查詢叢集安裝的組件詳情。

查詢叢集組件版本

調用DescribeClusterAddonsVersion查詢指定叢集的組件版本。

查詢叢集組件升級狀態

調用DescribeClusterAddonsUpgradeStatus同時查詢多個組件的升級狀態。

查詢叢集組件版本中繼資料

調用DescribeClusterAddonMetadata查詢特定叢集可使用的指定組件版本資訊,包括組件版本、可配置參數等。

修改叢集組件配置

調用ModifyClusterAddon修改已安裝的叢集組件配置。

升級叢集組件

調用UpgradeClusterAddons將指定組件升級到指定版本。

卸載叢集組件

調用UnInstallClusterAddons卸載指定叢集的組件。

標籤

API

描述

綁定資源標籤

調用TagResources為指定的叢集綁定特定標籤。

修改叢集標籤

調用ModifyClusterTags修改當前Kubernetes叢集的標籤。

查詢資源標籤列表

調用ListTagResources查詢可見的資源標籤關係。

解除綁定資源標籤

調用UntagResources為指定的叢集解除綁定標籤。

策略治理

API

描述

在指定叢集中部署策略規則執行個體

調用DeployPolicyInstance在指定叢集中部署策略規則執行個體。

列舉策略治理規則庫列表

調用DescribePolicies列舉策略治理規則庫列表。

在指定叢集中更新策略規則執行個體

調用ModifyPolicyInstance在指定叢集中更新策略規則執行個體。

在指定叢集中刪除策略規則執行個體

調用DeletePolicyInstance在指定叢集中刪除策略規則執行個體。

擷取策略治理規則模板詳情

調用DescribePolicyDetails擷取策略治理規則模板詳情。

擷取叢集策略治理詳情

調用DescribePolicyGovernanceInCluster擷取叢集策略治理詳情。

擷取叢集中當前部署的策略執行個體

調用DescribePolicyInstances擷取叢集中當前部署的策略執行個體列表。

擷取叢集中策略規則執行個體詳情

調用DescribePolicyInstancesStatus擷取叢集當前不同策略類型對應的執行個體部署狀態,包括每種策略規則對應開啟的執行個體計數,以及不同治理等級下開啟的策略種類計數。