DescribeClusterEvents - 查詢指定叢集的事件 - Container Service for Kubernetes

叢集操作事件包括叢集建立、叢集變更、節點池建立、節點池擴容、Addon安裝、叢集升級等。您可以調用DescribeClusterEvents介面，擷取指定叢集中發生的事件列表，並查詢事件的詳細資料，包括事件層級、時間狀態、時間發生時間等。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:DescribeClusterEvents

get

*Cluster

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

無

請求文法

GET /clusters/{ClusterId}/events HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
ClusterId	string	是	叢集 ID。	c82e6987e2961451182edacd74faf****

請求參數

名稱	類型	必填	描述	樣本值
page_size	integer	否	每頁顯示的最大結果數。取值範圍：[1,100]。預設值：50。	50
page_number	integer	否	分頁頁數。	1
next_token	string	否
max_results	integer	否
task_id	string	否	查詢的任務 ID。	T-6823f946ffadbb0106****

返回參數

名稱	類型	描述	樣本值
	object	返回體參數。
events	array<object>	事件列表。
	array<object>
event_id	string	事件 ID。	e-9ad04f72-8ee7-46bf-a02c-e4a06b39****
type	string	事件類型。取值： cluster_create：建立叢集。 cluster_scaleout：擴容叢集。 cluster_attach：添加已有節點。 cluster_delete：刪除叢集。 cluster_upgrade：升級叢集。 cluster_migrate：遷移叢集。 cluster_node_delete：移除節點。 cluster_node_drain：清空節點。 cluster_modify：修改叢集。 cluster_configuration_modify：修改叢集管控配置。 cluster_addon_install：安裝組件。 cluster_addon_upgrade：升級組件。 cluster_addon_uninstall：卸載組件。 runtime_upgrade：升級運行時。 nodepool_upgrade：升級節點池。 nodepool_update：更新節點池。	nodepool_update
source	string	事件來源。	task
subject	string	事件關聯的操作對象。	npdd89dc2b76c04f14b06774883b******
time	string	事件開始時間。	2025-05-14T10:00:56+08:00
cluster_id	string	叢集 ID。	c82e6987e2961451182edacd74faf****
data	object	事件描述。
level	string	事件層級。枚舉值： warning : warning error : error info : info	info
reason	string	事件狀態。	Started
message	string	事件詳情。	Start to upgrade NodePool nodePool/npdd89dc2b76c04f14b06774883b******
next_token	string
page_info	object	分頁資訊。
page_size	integer	每頁顯示的最大結果數。	50
page_number	integer	分頁頁數。	1
total_count	integer	結果總數。	126

樣本

正常返回樣本

JSON格式

{
  "events": [
    {
      "event_id": "e-9ad04f72-8ee7-46bf-a02c-e4a06b39****",
      "type": "nodepool_update",
      "source": "task",
      "subject": "npdd89dc2b76c04f14b06774883b******",
      "time": "2025-05-14T10:00:56+08:00",
      "cluster_id": "c82e6987e2961451182edacd74faf****",
      "data": {
        "level": "info",
        "reason": "Started",
        "message": "Start to upgrade NodePool nodePool/npdd89dc2b76c04f14b06774883b******"
      }
    }
  ],
  "next_token": "",
  "page_info": {
    "page_size": 50,
    "page_number": 1,
    "total_count": 126
  }
}

錯誤碼

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

變更歷史

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