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 |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
Nazwa puli agentów. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
resource
|
path | True |
string minLength: 1maxLength: 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. |
|
subscription
|
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 |
Operacja Azure zakończyła się pomyślnie. |
|
| Other Status Codes |
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 |
|---|---|
|
Agent |
Wersja historyczna, która może być używana do operacji wycofywania. |
|
Agent |
Lista dostępnych uaktualnień dla puli agentów. |
|
Agent |
Dostępne ulepszenia dla AgentPool. |
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
| OSType |
Typ systemu operacyjnego. Wartość domyślna to Linux. |
|
system |
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 | Linux |
Typ systemu operacyjnego. Wartość domyślna to Linux. |
|
| properties.recentlyUsedVersions |
Lista historycznych dobrych wersji dla operacji wycofywania. |
||
| properties.upgrades |
Lista typów orkiestratorów i wersji dostępnych do uaktualnienia. |
||
| 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 |
Dodatkowe informacje o błędzie |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |