Managed Clusters - List Kubernetes Versions
指定したサブスクリプションでサポートされている Kubernetes バージョンの一覧を取得します。
サポートされているパッチ バージョン、機能、使用可能なアップグレード、バージョンのプレビュー状態の詳細など、バージョンに関する追加のメタデータが含まれます
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/locations/{location}/kubernetesVersions?api-version=2024-02-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
location
|
path | True |
string |
Azure リージョンの名前。 |
subscription
|
path | True |
string uuid |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
List Kubernetes Versions
Sample Request
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/location1/kubernetesVersions?api-version=2024-02-01
Sample Response
{
"values": [
{
"version": "1.23",
"capabilities": {
"supportPlan": [
"KubernetesOfficial"
]
},
"patchVersions": {
"1.23.12": {
"upgrades": [
"1.23.15",
"1.24.6",
"1.24.9"
]
},
"1.23.15": {
"upgrades": [
"1.24.6",
"1.24.9"
]
}
}
},
{
"version": "1.24",
"isDefault": true,
"capabilities": {
"supportPlan": [
"KubernetesOfficial"
]
},
"patchVersions": {
"1.24.6": {
"upgrades": [
"1.24.9",
"1.25.4",
"1.25.5"
]
},
"1.24.9": {
"upgrades": [
"1.25.4",
"1.25.5"
]
}
}
},
{
"version": "1.25",
"capabilities": {
"supportPlan": [
"KubernetesOfficial"
]
},
"patchVersions": {
"1.25.4": {
"upgrades": [
"1.25.5",
"1.26.0"
]
},
"1.25.5": {
"upgrades": [
"1.26.0"
]
}
}
},
{
"version": "1.26",
"isPreview": true,
"capabilities": {
"supportPlan": [
"KubernetesOfficial"
]
},
"patchVersions": {
"1.26.0": {
"upgrades": []
}
}
}
]
}
定義
名前 | 説明 |
---|---|
Cloud |
コンテナー サービスからのエラー応答。 |
Cloud |
コンテナー サービスからのエラー応答。 |
Kubernetes |
Kubernetes パッチ バージョン プロファイル |
Kubernetes |
AKS マネージド クラスターのさまざまなサポート層 |
Kubernetes |
特定の major.minor リリースの Kubernetes バージョン プロファイル。 |
Kubernetes |
この Kubernetes バージョンの機能。 |
Kubernetes |
値のプロパティを保持します。これは KubernetesVersion の配列です |
CloudError
コンテナー サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラーの詳細。 |
CloudErrorBody
コンテナー サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。 |
details |
エラーに関するその他の詳細の一覧。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
KubernetesPatchVersion
Kubernetes パッチ バージョン プロファイル
名前 | 型 | 説明 |
---|---|---|
upgrades |
string[] |
特定のパッチ バージョンに対して可能なアップグレード パス |
KubernetesSupportPlan
AKS マネージド クラスターのさまざまなサポート層
名前 | 型 | 説明 |
---|---|---|
AKSLongTermSupport |
string |
バージョンのサポートは、KubernetesOfficial サポートから 1 年間延長されました。 AKS では、さらに 1 年間、合計 2 年間のサポートのために CVE にパッチを適用し続けています。 |
KubernetesOfficial |
string |
バージョンのサポートは、オープンソース Kubernetes オファリングの場合と同じです。 公式 Kubernetes オープンソースコミュニティ サポート バージョンは、リリース後 1 年間です。 |
KubernetesVersion
特定の major.minor リリースの Kubernetes バージョン プロファイル。
名前 | 型 | 説明 |
---|---|---|
capabilities |
この Kubernetes バージョンの機能。 |
|
isDefault |
boolean |
このバージョンが既定かどうか。 |
isPreview |
boolean |
このバージョンがプレビュー モードかどうか。 |
patchVersions |
<string,
Kubernetes |
Kubernetes リリースのパッチ バージョン |
version |
string |
kubernetes リリースの major.minor バージョン |
KubernetesVersionCapabilities
この Kubernetes バージョンの機能。
名前 | 型 | 説明 |
---|---|---|
supportPlan |
AKS マネージド クラスターのさまざまなサポート層 |
KubernetesVersionListResult
値のプロパティを保持します。これは KubernetesVersion の配列です
名前 | 型 | 説明 |
---|---|---|
values |
AKS でサポートされている Kubernetes バージョンの配列。 |