Freigeben über

Problembehandlung für InvalidParameter-Fehler

In diesem Artikel wird erläutert, wie Sie den Fehler identifizieren und beheben, der InvalidParameter auftritt, wenn Sie versuchen, einen Microsoft Azure Kubernetes Service (AKS)-Cluster zu erstellen und bereitzustellen.

Voraussetzungen

  • Azure CLI, Version 2.0.81 oder höher. Wenn Azure CLI bereits installiert ist, finden Sie die Versionsnummer, indem Sie ausführen az --version.

Problembeschreibung

Wenn Sie einen AKS-Cluster erstellen, werden die bereitgestellten Konfigurationen in der Regel überprüft, bevor der Cluster erstellt wird. In seltenen Fällen übergibt ein Parameter jedoch die Überprüfung, bevor der AKS-Cluster erstellt wird, verursacht jedoch Fehler, wenn die Ressourcen für den Cluster erstellt werden. Fehler, die mit ungültigen Parametern zusammenhängen, können den folgenden Beispielen ähneln:

  • Szenario: Die ausgewählte VM-Größe ist nicht verfügbar.

    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"

  • Szenario: Clusternamen sind nicht verfügbar oder stehen im Konflikt mit reservierten Azure-Werten

    • Beispiel 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."

    • Beispiel 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."

    • Beispiel 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"

Ursache

Dieses Problem tritt auf, da eine der folgenden Bedingungen zutrifft:

  • Die SKU des virtuellen Azure-Computers ist in der ausgewählten Region nicht verfügbar.
  • Der Dienstprinzipal ist ungültig.
  • Eine virtuelle Netzwerk-, Subnetz- oder Routentabelle ist ungültig.
  • Ein Azure CLI-Parameter ist ungültig.
  • Der Wert des Parameternamens ist von Azure nicht verfügbar oder reserviert.

Es kann auch andere Gründe geben, warum der Clustererstellungsversuch fehlgeschlagen ist.

Lösung

Folgen Sie in der folgenden Tabelle dem Link für den entsprechenden Schritt zur Problembehandlung.

Schritte zur Problembehandlung Referenzlink
Überprüfen, ob die SKU verfügbar ist Beheben des Fehlers vom Typ „SKU nicht verfügbar“
Überprüfen, ob der Dienstprinzipal gültig ist Dienstprinzipale zusammen mit AKS
Überprüfen, ob alle Befehle, die zum Erstellen des Clusters verwendet wurden, gültig sind az aks (Azure CLI-Referenz)
Überprüfen, ob alle benutzerdefinierten Netzwerkressourcen, die zum Erstellen des Clusters verwendet wurden, gültig sind Konfigurieren von Azure CNI-Netzwerken in AKS und Anpassen des Clusterausgangs mit einer benutzerdefinierten Route
Vermeiden der Verwendung nicht verfügbarer oder von Azure reservierter Werte für Namen Verweisen auf die bereitgestellten Fehlermeldungen

Weitere Informationen

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.