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
agentPoolName
path True

string

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

Nom du pool d’agents.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

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

Nom de la ressource de cluster géré.

subscriptionId
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

AgentPoolUpgradeProfile

Opération Azure terminée avec succès.

Other Status Codes

ErrorResponse

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
AgentPoolRecentlyUsedVersion

Version historique qui peut être utilisée pour les opérations de restauration.

AgentPoolUpgradeProfile

Liste des mises à niveau disponibles pour un pool d’agents.

AgentPoolUpgradeProfilePropertiesUpgradesItem

Améliorations disponibles pour un Agent Pool.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

OSType

Type de système d’exploitation. La valeur par défaut est Linux.

systemData

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

OSType

Linux

Type de système d’exploitation. La valeur par défaut est Linux.

properties.recentlyUsedVersions

AgentPoolRecentlyUsedVersion[]

Liste des versions correctes historiques pour les opérations de restauration.

properties.upgrades

AgentPoolUpgradeProfilePropertiesUpgradesItem[]

Liste des types et versions d’orchestrateur disponibles pour la mise à niveau.

systemData

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

ErrorAdditionalInfo[]

Informations complémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

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

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

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.