Agent Pools - Get Upgrade Profile

Dienst:: AKS

API-Version:: 2026-06-01

Ruft das Upgradeprofil für einen Agentpool ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default?api-version=2026-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Der Name des Agentpools.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	Der Name der verwalteten Clusterressource.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	AgentPoolUpgradeProfile	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

Get Upgrade Profile for Agent Pool

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeProfiles/default?api-version=2026-06-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "default",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/upgradeProfiles",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeprofiles/default",
  "properties": {
    "kubernetesVersion": "1.12.8",
    "latestNodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "osType": "Linux",
    "upgrades": [
      {
        "kubernetesVersion": "1.13.5"
      }
    ]
  }
}

Definitionen

Name	Beschreibung
AgentPoolRecentlyUsedVersion	Eine historische Version, die für Rollback-Vorgänge verwendet werden kann.
AgentPoolUpgradeProfile	Die Liste der verfügbaren Upgrades für einen Agentpool.
AgentPoolUpgradeProfilePropertiesUpgradesItem	Verfügbare Upgrades für einen AgentPool.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
OSType	Der Betriebssystemtyp. Der Standardwert ist Linux.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AgentPoolRecentlyUsedVersion

Objekt

Eine historische Version, die für Rollback-Vorgänge verwendet werden kann.

Name	Typ	Beschreibung
nodeImageVersion	string	Die Version des Knotenimages, die für das Rollback verfügbar ist.
orchestratorVersion	string	Die Kubernetes-Version (major.minor.patch), die für das Rollback verfügbar ist.
timestamp	string (date-time)	Der Zeitstempel, zu dem diese Version zuletzt verwendet wurde.

AgentPoolUpgradeProfile

Objekt

Die Liste der verfügbaren Upgrades für einen Agentpool.

Name	Typ	Standardwert	Beschreibung
id	string (arm-id)		Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Der Name der Ressource
properties.kubernetesVersion	string		Die Kubernetes-Version (major.minor.patch).
properties.latestNodeImageVersion	string		Die neueste AKS unterstützte Knotenimageversion.
properties.osType	OSType	Linux	Der Betriebssystemtyp. Der Standardwert ist Linux.
properties.recentlyUsedVersions	AgentPoolRecentlyUsedVersion[]		Liste der fehlerhaften Verlaufsversionen für Rollback-Vorgänge.
properties.upgrades	AgentPoolUpgradeProfilePropertiesUpgradesItem[]		Liste der Orchestratortypen und -versionen, die für das Upgrade verfügbar sind.
systemData	systemData		Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string		Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AgentPoolUpgradeProfilePropertiesUpgradesItem

Objekt

Verfügbare Upgrades für einen AgentPool.

Name	Typ	Beschreibung
isPreview	boolean	Gibt an, ob sich die Kubernetes-Version derzeit in der Vorschau befindet.
kubernetesVersion	string	Die Kubernetes-Version (major.minor.patch).

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

OSType

Enumeration

Der Betriebssystemtyp. Der Standardwert ist Linux.

Wert	Beschreibung
Linux	Verwenden Sie Linux.
Windows	Verwenden Sie Windows.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.