Managed Clusters - List Kubernetes Versions

Service:

AKS

API-versie:

2024-10-01

Hiermee haalt u een lijst op met ondersteunde Kubernetes-versies in het opgegeven abonnement.
Bevat extra metagegevens voor de versie, waaronder ondersteunde patchversies, mogelijkheden, beschikbare upgrades en details over de preview-status van de versie

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/locations/{location}/kubernetesVersions?api-version=2024-10-01

URI-parameters

Name	In	Vereist	Type	Description
location	path	True	string	De naam van de Azure-regio.
subscriptionId	path	True	string uuid	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	KubernetesVersionListResult	OK
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List Kubernetes Versions

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/location1/kubernetesVersions?api-version=2024-10-01

Voorbeeldrespons

Statuscode:

200

{
  "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": []
        }
      }
    }
  ]
}

Definities

Name	Description
CloudError	Een foutreactie van de Container-service.
CloudErrorBody	Een foutreactie van de Container-service.
KubernetesPatchVersion	Kubernetes-patchversieprofiel
KubernetesSupportPlan	Verschillende ondersteuningslagen voor door AKS beheerde clusters
KubernetesVersion	Kubernetes-versieprofiel voor de opgegeven major.minor-release.
KubernetesVersionCapabilities	Mogelijkheden voor deze Kubernetes-versie.
KubernetesVersionListResult	Eigenschappen van bewaringswaarden, wat een matrix van KubernetesVersion is

CloudError

Object

Een foutreactie van de Container-service.

Name	Type	Description
error	CloudErrorBody	Details over de fout.

CloudErrorBody

Object

Een foutreactie van de Container-service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende informatie over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

KubernetesPatchVersion

Object

Kubernetes-patchversieprofiel

Name	Type	Description
upgrades	string[]	Mogelijk upgradepad voor bepaalde patchversie

KubernetesSupportPlan

Enumeration

Verschillende ondersteuningslagen voor door AKS beheerde clusters

Waarde	Description
AKSLongTermSupport	Ondersteuning voor de versie die is verlengd na de KubernetesOfficial-ondersteuning van 1 jaar. AKS blijft cv's patchen voor nog eens 1 jaar, voor een totaal van 2 jaar ondersteuning.
KubernetesOfficial	Ondersteuning voor de versie is hetzelfde als voor de open source Kubernetes-aanbieding. Officiële opensource-communityversies van Kubernetes gedurende 1 jaar na de release.

KubernetesVersion

Object

Kubernetes-versieprofiel voor de opgegeven major.minor-release.

Name	Type	Description
capabilities	KubernetesVersionCapabilities	Mogelijkheden voor deze Kubernetes-versie.
isDefault	boolean	Of deze versie standaard is.
isPreview	boolean	Of deze versie zich in de preview-modus bevindt.
patchVersions	<string,  KubernetesPatchVersion>	Patchversies van Kubernetes-release
version	string	major.minor-versie van Kubernetes-release

KubernetesVersionCapabilities

Object

Mogelijkheden voor deze Kubernetes-versie.

Name	Type	Description
supportPlan	KubernetesSupportPlan[]	Verschillende ondersteuningslagen voor door AKS beheerde clusters

KubernetesVersionListResult

Object

Eigenschappen van bewaringswaarden, wat een matrix van KubernetesVersion is

Name	Type	Description
values	KubernetesVersion[]	Matrix van ondersteunde Kubernetes-versies van AKS.