Condividi tramite


Risolvere l'errore InvalidParameter

Questo articolo illustra come identificare e risolvere l'errore InvalidParameter che si verifica quando si tenta di creare e distribuire un cluster Microsoft servizio Azure Kubernetes (AKS).

Prerequisiti

  • Interfaccia della riga di comando di Azure, versione 2.0.81 o successiva. Se Azure CLI è già installato, puoi trovare il numero di versione eseguendo az --version.

Sintomi

Quando si crea un cluster del servizio Azure Kubernetes, le configurazioni fornite vengono in genere convalidate prima della creazione del cluster. Tuttavia, in rari casi, un parametro può superare la convalida prima della creazione del cluster AKS, ma causare errori quando vengono create le risorse per il cluster. Gli errori correlati a parametri non validi potrebbero essere simili agli esempi seguenti:

  • Scenario: le dimensioni della macchina virtuale selezionate non sono disponibili

    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"
    
  • Scenario: i nomi dei cluster non sono disponibili o sono in conflitto con i valori riservati di Azure

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

Motivo

Questo problema si verifica perché una delle condizioni seguenti è vera:

  • Lo SKU della macchina virtuale di Azure non è disponibile nell'area selezionata.
  • Il principale del servizio è invalido.
  • Una rete virtuale, una subnet o una tabella di route non è valida.
  • Un parametro dell'interfaccia della riga di comando di Azure non è valido.
  • Il valore del nome del parametro non è disponibile o riservato da Azure.

Potrebbero anche verificarsi altri motivi per cui il tentativo di creazione del cluster non è riuscito.

Soluzione

Nella tabella seguente seguire il collegamento per il passaggio appropriato per la risoluzione dei problemi.

Passaggio per la risoluzione dei problemi Collegamento di riferimento
Controllare se lo SKU è disponibile Risolvere gli errori dovuti all'indisponibilità di SKU
Verificare che il principale del servizio sia valido Principali del servizio insieme ad AKS
Verificare che tutti i comandi usati per creare il cluster siano validi az aks (riferimento per l'interfaccia della riga di comando di Azure)
Verificare che le risorse di rete personalizzate usate per creare il cluster siano valide Configurare la rete CNI di Azure in AKS e Modificare l'egresso del cluster con una route definita dall'utente
Evitare di usare valori non disponibili o riservati di Azure per i nomi Fare riferimento ai messaggi di errore forniti

Maggiori informazioni

Contattaci per ricevere assistenza

In caso di domande, è possibile porre domande al supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.