UpgradeClusterAddons - Container Service for Kubernetes

介面說明

升級叢集元件執行個體版本可能會影響業務，請評估影響後在業務離峰期操作並提前做好相關的資料備份。
升級元件前，請參考元件發布紀錄了解指定元件的變更內容和變更影響。
請依序逐個元件升級，確認一個元件升級成功後再升級下一個元件。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:UpgradeK8sComponents

update

*Cluster

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

無

請求文法

POST /clusters/{ClusterId}/components/upgrade HTTP/1.1

路徑參數

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

請求參數

名稱	類型	必填	描述	樣本值
body	array<object>	否	請求參數。
	object	否	元件資訊。
component_name	string	是	元件名稱。	coredns
config	string	否	元件自訂參數，使用 JSON 字串編碼。	{"CpuRequest":"800m"}
next_version	string	是	待升級的目標版本。您可以呼叫`DescribeAddon`介面檢視元件可升級的版本。	v1.11.3.5-5321daf49-aliyun
policy	string	否	元件升級策略。可選值： overwrite：覆蓋升級。 canary：金絲雀升級。	canary
version	string	否	目前元件版本。	v1.11.3.2-f57ea7ed6-aliyun

返回參數

名稱	類型	描述	樣本值
	object
cluster_id	string	叢集 ID。	cf4299b79b3e34226abfdc80a4bda****
request_id	string	請求 ID。	bfd12953-31cb-42f1-8a36-7b80ec34****
task_id	string	任務 ID。	T-62a944794ee141074400****

樣本

正常返回樣本

JSON格式

{
  "cluster_id": "cf4299b79b3e34226abfdc80a4bda****",
  "request_id": "bfd12953-31cb-42f1-8a36-7b80ec34****",
  "task_id": "T-62a944794ee141074400****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	AddonPreviewUnsupported	upgrade preview is not supported for component

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

變更歷史

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