您可以調(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ā)生變更 | 查看變更詳情 |