Agent Pools - Get Upgrade Profile

Pobiera profil uaktualniania dla puli agentów.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
agentPoolName
path True

string

minLength: 1
maxLength: 12
pattern: ^[a-z][a-z0-9]{0,11}$

Nazwa puli agentów.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

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]$

Nazwa zasobu klastra zarządzanego.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

AgentPoolUpgradeProfile

Operacja Azure zakończyła się pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation podszywaj się pod konto użytkownika

Przykłady

Get Upgrade Profile for Agent Pool

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
AgentPoolRecentlyUsedVersion

Wersja historyczna, która może być używana do operacji wycofywania.

AgentPoolUpgradeProfile

Lista dostępnych uaktualnień dla puli agentów.

AgentPoolUpgradeProfilePropertiesUpgradesItem

Dostępne ulepszenia dla AgentPool.

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

OSType

Typ systemu operacyjnego. Wartość domyślna to Linux.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AgentPoolRecentlyUsedVersion

Wersja historyczna, która może być używana do operacji wycofywania.

Nazwa Typ Opis
nodeImageVersion

string

Wersja obrazu węzła dostępna do wycofania.

orchestratorVersion

string

Wersja platformy Kubernetes (główna.pomocnicza) dostępna do wycofania.

timestamp

string (date-time)

Sygnatura czasowa, kiedy ta wersja była ostatnio używana.

AgentPoolUpgradeProfile

Lista dostępnych uaktualnień dla puli agentów.

Nazwa Typ Domyślna wartość Opis
id

string (arm-id)

W pełni określony identyfikator zasobu dla tego zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.kubernetesVersion

string

Wersja platformy Kubernetes (główna.pomocnicza.patch).

properties.latestNodeImageVersion

string

Najnowsza obsługiwana wersja obrazu węzła usługi AKS.

properties.osType

OSType

Linux

Typ systemu operacyjnego. Wartość domyślna to Linux.

properties.recentlyUsedVersions

AgentPoolRecentlyUsedVersion[]

Lista historycznych dobrych wersji dla operacji wycofywania.

properties.upgrades

AgentPoolUpgradeProfilePropertiesUpgradesItem[]

Lista typów orkiestratorów i wersji dostępnych do uaktualnienia.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

AgentPoolUpgradeProfilePropertiesUpgradesItem

Dostępne ulepszenia dla AgentPool.

Nazwa Typ Opis
isPreview

boolean

Czy wersja rozwiązania Kubernetes jest obecnie dostępna w wersji zapoznawczej.

kubernetesVersion

string

Wersja platformy Kubernetes (główna.pomocnicza.patch).

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

OSType

Typ systemu operacyjnego. Wartość domyślna to Linux.

Wartość Opis
Linux

Użyj systemu Linux.

Windows

Użyj systemu Windows.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.