DescribeKubernetesVersionMetadata - 查詢Kubernetes版本的詳細詳情 - Container Service for Kubernetes

您可以調用DescribeKubernetesVersionMetadata介面查詢Kubernetes版本的詳細資料，包括Kubernetes版本資訊、版本的發布日期和到期時間、相容的作業系統，使用的運行時等。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:DescribeKubernetesVersionMetadata

get

*全部資源

*

無

請求文法

GET /api/v1/metadata/versions HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
Region	string	是	叢集所在地區 ID。	cn-beijing
ClusterType	string	是	叢集類型，取值： `Kubernetes`: ACK 專有版叢集。 `ManagedKubernetes`：ACK 託管版叢集，包括 ACK Pro 版叢集、ACK 基礎版叢集、ACK Serverless Pro 版叢集、ACK Serverless 基礎版叢集、ACK Edge Pro 版叢集、ACK Edge 基礎版。	Kubernetes
KubernetesVersion	string	否	叢集版本，與 Kubernetes 社區基準版本保持一致。建議選擇最新版本，若不指定，預設使用最新版本。 ACK 支援的 Kubernetes 版本，請參見 Kubernetes 版本發布概覽。	1.32.1-aliyun.1
Profile	string	否	面向情境時的叢集類型，取值： `Default`：非邊緣情境叢集。 `Edge`：邊緣情境叢集。 `Serverless`：ASK 叢集。預設值：`Default`。	Default
runtime	string	否	運行時類型，可以通過指定運行時類型，過濾出運行時所支援的系統鏡像，取值： `docker`：docker 運行時。 `containerd`：containerd 運行時。 `Sandboxed-Container.runv`：安全沙箱。若指定運行時類型，將返回指定運行時支援的鏡像版本。若不指定運行時類型，預設返回全部鏡像。	containerd
Mode	string	否	查詢模式，取值： `supported`：查詢受支援版本。 `creatable`：查詢可建立版本。若指定`KubernetesVersion`，將忽略查詢模式。若不指定查詢模式，預設返回可建立版本。	supported
QueryUpgradableVersion	boolean	否	是否查詢該叢集版本的可升級版本，僅在指定 KubernetesVersion 參數時生效。 true：查詢可升級版本。 false：不查詢可升級版本。	1.30.1-aliyun.1

返回參數

名稱	類型	描述	樣本值
	array	叢集版本詳情列表。
	array<object>	版本詳情。
capabilities	object	Kubernetes 版本功能特性。	{ "AnyAZ": true, "ChargeType": "PostPaid" }
images	array<object>	系統鏡像列表。
	object	鏡像詳情。
image_id	string	鏡像 ID。	aliyun_3_x64_20G_alibase_20241218.vhd
image_name	string	鏡像名稱。	Alibaba Cloud Linux 3.2104
platform	string	作業系統平台。取值： `AliyunLinux` `CentOS` `Windows` `WindowsCore`	AliyunLinux
os_version	string	鏡像版本。	3.2104
image_type	string	作業系統發行版類型，推薦使用該欄位指定節點作業系統。取值： `CentOS` `AliyunLinux` `AliyunLinux Qboot` `AliyunLinuxUEFI` `AliyunLinux3` `Windows` `WindowsCore` `AliyunLinux3Arm64` `ContainerOS`	AliyunLinux3
os_type	string	作業系統類型，例如： `Windows` `Linux`	Linux
image_category	string	鏡像分類，部分取值： `system`：公用鏡像。 `self`：您的自訂鏡像。 `others`：其他使用者的公開鏡像。 `marketplace`：鏡像市場鏡像。	system
architecture	string	鏡像架構。	x86_64
meta_data	object	Kubernetes 版本中繼資料資訊。	{ "KubernetesVersion": "1.31.1-aliyun.1", "SubClass": "default", "ServiceCIDR": "" }
runtimes	array	容器運行時配置。
	runtime	容器運行時配置。
version	string	ACK 發布的 Kubernetes 版本。更多版本資訊，請參見 Kubernetes 版本發布概覽。	1.31.1-aliyun.1
release_date	string	Kubernetes 版本發布時間。	2025-01-30T00:00:00Z
expiration_date	string	Kubernetes 版本到期時間。	2026-01-30T00:00:00Z
creatable	boolean	Kubernetes 版本是否可建立。	true
upgradable_versions	array	可升級的版本列表。
	string	可升級的版本。	1.32.1-aliyun.1

樣本

正常返回樣本

JSON格式

[
  {
    "capabilities": {
      "AnyAZ": true,
      "ChargeType": "PostPaid"
    },
    "images": [
      {
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "image_name": "Alibaba Cloud Linux 3.2104",
        "platform": "AliyunLinux",
        "os_version": "3.2104",
        "image_type": "AliyunLinux3",
        "os_type": "Linux",
        "image_category": "system",
        "architecture": "x86_64"
      }
    ],
    "meta_data": {
      "KubernetesVersion": "1.31.1-aliyun.1",
      "SubClass": "default",
      "ServiceCIDR": ""
    },
    "runtimes": [
      {
        "name": "containerd",
        "version": "1.6.20"
      }
    ],
    "version": "1.31.1-aliyun.1",
    "release_date": "2025-01-30T00:00:00Z",
    "expiration_date": "2026-01-30T00:00:00Z",
    "creatable": true,
    "upgradable_versions": [
      "1.32.1-aliyun.1"
    ]
  }
]

錯誤碼

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

變更歷史

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