Agent Pools - Get Upgrade Profile
Obtient le profil de mise à niveau d’un pool d’agents.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default?api-version=2026-06-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
Nom du pool d’agents. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
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]$ |
Nom de la ressource de cluster géré. |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération Azure terminée avec succès. |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Flux OAuth2 d’Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | Usurper l’identité de votre compte utilisateur |
Exemples
Get Upgrade Profile for Agent Pool
Exemple de requête
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
Exemple de réponse
{
"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"
}
]
}
}
Définitions
| Nom | Description |
|---|---|
|
Agent |
Version historique qui peut être utilisée pour les opérations de restauration. |
|
Agent |
Liste des mises à niveau disponibles pour un pool d’agents. |
|
Agent |
Améliorations disponibles pour un Agent Pool. |
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
| OSType |
Type de système d’exploitation. La valeur par défaut est Linux. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
AgentPoolRecentlyUsedVersion
Version historique qui peut être utilisée pour les opérations de restauration.
| Nom | Type | Description |
|---|---|---|
| nodeImageVersion |
string |
Version de l’image de nœud disponible pour la restauration. |
| orchestratorVersion |
string |
La version de Kubernetes (major.minor.patch) disponible pour la restauration. |
| timestamp |
string (date-time) |
L’horodatage de la dernière utilisation de cette version. |
AgentPoolUpgradeProfile
Liste des mises à niveau disponibles pour un pool d’agents.
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
| id |
string (arm-id) |
Identifiant de ressource entièrement qualifié pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
|
| name |
string |
nom de la ressource. |
|
| properties.kubernetesVersion |
string |
Version de Kubernetes (major.minor.patch). |
|
| properties.latestNodeImageVersion |
string |
Dernière version de l’image de nœud prise en charge par AKS. |
|
| properties.osType | Linux |
Type de système d’exploitation. La valeur par défaut est Linux. |
|
| properties.recentlyUsedVersions |
Liste des versions correctes historiques pour les opérations de restauration. |
||
| properties.upgrades |
Liste des types et versions d’orchestrateur disponibles pour la mise à niveau. |
||
| systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
||
| type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
AgentPoolUpgradeProfilePropertiesUpgradesItem
Améliorations disponibles pour un Agent Pool.
| Nom | Type | Description |
|---|---|---|
| isPreview |
boolean |
Indique si la version kubernetes est actuellement en préversion. |
| kubernetesVersion |
string |
Version de Kubernetes (major.minor.patch). |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom | Type | Description |
|---|---|---|
| info |
object |
Informations supplémentaires |
| type |
string |
Le type d’informations supplémentaires. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations complémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
OSType
Type de système d’exploitation. La valeur par défaut est Linux.
| Valeur | Description |
|---|---|
| Linux |
Utilisez Linux. |
| Windows |
Utilisez Windows. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |