您可以調(diào)用DescribeKubernetesVersionMetadata接口查詢Kubernetes版本的詳細信息，包括Kubernetes版本信息、版本的發(fā)布日期和過期時間、兼容的操作系統(tǒng)，使用的運行時等。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| cs:DescribeKubernetesVersionMetadata | get |
|
| 無 |
請求語法
GET /api/v1/metadata/versions HTTP/1.1
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Region | string | 是 | 集群所在地域 ID。 | cn-beijing |
| ClusterType | string | 是 | 集群類型，取值：
| Kubernetes |
| KubernetesVersion | string | 否 | 集群版本，與 Kubernetes 社區(qū)基線版本保持一致。建議選擇最新版本，若不指定，默認使用最新版本。 目前在 ACK 控制臺您可以創(chuàng)建兩種最新版本的集群。您可以通過 API 創(chuàng)建其他 Kubernetes 版本集群。ACK 支持的 Kubernetes 版本，請參見 Kubernetes 版本發(fā)布概覽。 | 1.28.3-aliyun.1 |
| Profile | string | 否 | 面向場景時的集群類型，取值：
默認值： | Default |
| runtime | string | 否 | 運行時類型，可以通過指定運行時類型，過濾出運行時所支持的系統(tǒng)鏡像，取值：
若指定運行時類型，將返回指定運行時支持的鏡像版本。 若不指定運行時類型，默認返回全部鏡像。 | containerd |
| Mode | string | 否 | 查詢模式，取值：
若指定 若不指定查詢模式，默認返回可創(chuàng)建版本。 | supported |
| QueryUpgradableVersion | boolean | 否 | 是否查詢該集群版本的可升級版本，僅在指定 KubernetesVersion 參數(shù)時生效。 | 1.30.1-aliyun.1 |
返回參數(shù)
示例
正常返回示例
JSON格式
[
{
"capabilities": {
"test": "test",
"test2": 1
},
"images": [
{
"image_id": "centos_7_9_x64_20G_alibase_20221129.vhd",
"image_name": "CentOS 7.9",
"platform": "CentOS",
"os_version": "7.9",
"image_type": "CentOS",
"os_type": "Linux",
"image_category": "system",
"architecture": "x86_64"
}
],
"meta_data": {
"test": "test",
"test2": 1
},
"runtimes": [
{
"name": "containerd",
"version": "1.6.20"
}
],
"version": "1.28.3-aliyun.1",
"release_date": "2023-04-30T00:00:00Z",
"expiration_date": "2025-04-30T00:00:00Z",
"creatable": true,
"upgradable_versions": [
"1.30.1-aliyun.1"
]
}
]錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-05-14 | OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |
| 2023-07-18 | OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |