Partager via

Résoudre les problèmes liés à l’erreur InvalidParameter

Cet article explique comment identifier et résoudre l’erreur InvalidParameter qui se produit lorsque vous essayez de créer et de déployer un cluster Microsoft Azure Kubernetes Service (AKS).

Conditions préalables

  • Azure CLI, version 2.0.81 ou ultérieure. Si Azure CLI est déjà installé, vous pouvez trouver le numéro de version en exécutant az --version.

Symptômes

Lorsque vous créez un cluster AKS, les configurations fournies sont généralement validées avant la création du cluster. Toutefois, à de rares occasions, un paramètre passe la validation avant la création du cluster AKS, mais provoque des erreurs lorsque les ressources du cluster sont créées. Les erreurs liées aux paramètres non valides peuvent ressembler aux exemples suivants :

  • Scénario : la taille de machine virtuelle sélectionnée n’est pas disponible

    Code="InvalidParameter"

Message="**The requested VM size Standard_D4s_v3 is not available in the current region. The sizes available in the current region are: ExtraSmall_Internal, Small_Internal, Medium_Internal, Large_Internal, ExtraLarge_Internal, Standard_DC2as_v5, Standard_DC4as_v5, Standard_DC8as_v5, Standard_DC16as_v5, Standard_DC32as_v5, Standard_DC48as_v5, Standard_DC64as_v5, Standard_DC96as_v5, Standard_DC2ads_v5, Standard_DC4ads_v5, Standard_DC8ads_v5, Standard_DC16ads_v5, Standard_DC32ads_v5, Standard_DC48ads_v5, Standard_DC64ads_v5, Standard_DC96ads_v5, Standard_EC2as_v5, Standard_EC4as_v5, Standard_EC8as_v5, Standard_EC16as_v5, Standard_EC20as_v5, Standard_EC32as_v5, Standard_EC48as_v5, Standard_EC64as_v5, Standard_EC96as_v5, Standard_EC96ias_v5, Standard_EC2ads_v5, Standard_EC4ads_v5, Standard_EC8ads_v5, Standard_EC16ads_v5, Standard_EC20ads_v5, Standard_EC32ads_v5, Standard_EC48ads_v5, Standard_EC64ads_v5, Standard_EC96ads_v5, Standard_EC96iads_v5.\r\nFind out more on the available VM sizes in each region at <https://aka.ms/azureregions>."

Target="vmSize"

  • Scénario : Les noms de cluster ne sont pas disponibles ou sont en conflit avec les valeurs réservées Azure

    • Exemple 1

      Code="InvalidParameter"

Message="The value of parameter name is invalid. Error details: "omsagent-aks-dev-microsoft" managed cluster name is invalid because 'MICROSOFT' and 'WINDOWS' can't be used as either a whole word or a substring in the name.. Please see https://aka.ms/aks-naming-rules for more details."

    • Exemple 2

      Message="The value of parameter name is invalid. Error details: "login" managed cluster name is invalid because 'LOGIN' and 'XBOX' can't be used at the start of a resource name, but can be used later in the name.. Please see https://aka.ms/aks-naming-rules for more details."

    • Exemple 3

      Message=" The value of parameter name is invalid. Error details: "azure" managed cluster name is invalid because it is reserved.. Please see https://aka.ms/aks-naming-rules for more details.
Target: name"

La cause

Ce problème se produit parce que l’une des conditions suivantes est vraie :

  • La référence SKU de machine virtuelle Azure n’est pas disponible dans la région sélectionnée.
  • Le principal de service n’est pas valide.
  • Un réseau virtuel, un sous-réseau ou une table de routage n’est pas valide.
  • Un paramètre Azure CLI n’est pas valide.
  • La valeur du nom du paramètre n’est pas disponible ou réservée par Azure.

Il peut également y avoir d’autres raisons pour lesquelles la tentative de création de votre cluster a échoué.

Solution

Dans le tableau suivant, suivez le lien correspondant à l’étape de résolution des problèmes appropriée.

Étape de dépannage Lien de référence
Vérifier si la référence SKU est disponible Résoudre les erreurs de SKU non disponibles
Vérifier que le principal de service est valide Principaux de service avec AKS
Vérifiez que toutes les commandes utilisées pour créer le cluster sont valides az aks (référence Azure CLI)
Vérifiez que toutes les ressources réseau personnalisées utilisées pour créer le cluster sont valides Configurer la mise en réseau Azure CNI dans AKS et personnaliser la sortie du cluster avec un itinéraire défini par l’utilisateur
Évitez d'utiliser des valeurs indisponibles ou réservées par Azure pour les noms Reportez-vous aux messages d’erreur fournis

Plus d’informations

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.