Partager via

Agent Pools - Get Available Agent Pool Versions

Service:
AKS
Version d'API:
2025-05-01

Obtient la liste des versions de Kubernetes prises en charge pour le pool d’agents spécifié.
Pour plus d’informations sur le cycle de vie des versions, consultez les versions de Kubernetes prises en charge .

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/availableAgentPoolVersions?api-version=2025-05-01

Paramètres URI

Nom Dans Obligatoire Type Description
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 managé.
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

AgentPoolAvailableVersions

Ok
Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Get available versions 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/availableAgentPoolVersions?api-version=2025-05-01

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/availableagentpoolversions",
  "name": "default",
  "properties": {
    "agentPoolVersions": [
      {
        "kubernetesVersion": "1.12.7"
      },
      {
        "kubernetesVersion": "1.12.8"
      },
      {
        "default": true,
        "kubernetesVersion": "1.13.5",
        "isPreview": true
      }
    ]
  },
  "type": "Microsoft.ContainerService/managedClusters/availableAgentpoolVersions"
}

Définitions

Nom Description
AgentPoolAvailableVersions

Liste des versions disponibles pour un pool d’agents.
AgentPoolVersions

Liste des versions disponibles pour le pool d’agents.
CloudError

Réponse d’erreur du service Conteneur.
CloudErrorBody

Réponse d’erreur du service Conteneur.

AgentPoolAvailableVersions

Object

Liste des versions disponibles pour un pool d’agents.

Nom Type Description
id

string

ID de la liste de versions du pool d’agents.
name

string

Nom de la liste des versions du pool d’agents.
properties.agentPoolVersions

AgentPoolVersions[]

Liste des versions disponibles pour le pool d’agents.
type

string

Type de la liste de versions du pool d’agents.

AgentPoolVersions

Object

Liste des versions disponibles pour le pool d’agents.

Nom Type Description
default

boolean

Indique si cette version est la version du pool d’agents par défaut.
isPreview

boolean

Indique si la version de Kubernetes est actuellement en préversion.
kubernetesVersion

string

Version de Kubernetes (major.minor.patch).

CloudError

Object

Réponse d’erreur du service Conteneur.

Nom Type Description
error

CloudErrorBody

Détails sur l’erreur.

CloudErrorBody

Object

Réponse d’erreur du service Conteneur.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.