Partilhar via

Solucionar problemas do erro invalidParameter

Este artigo discute como identificar e resolver o InvalidParameter erro que ocorre quando você tenta criar e implantar um cluster do AKS (Serviço de Kubernetes do Microsoft Azure).

Pré-requisitos

  • Azure CLI, versão 2.0.81 ou posterior. Se a CLI do Azure já estiver instalada, você poderá encontrar o número da versão executando az --version.

Sintomas

Quando você cria um cluster do AKS, as configurações fornecidas geralmente são validadas antes da criação do cluster. No entanto, em raras ocasiões, um parâmetro passa na validação antes que o cluster do AKS seja criado, mas causa erros quando os recursos do cluster são criados. Os erros relacionados a parâmetros inválidos podem ser semelhantes aos seguintes exemplos:

  • Cenário: o tamanho da VM selecionado não está disponível

    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"

  • Cenário: os nomes de cluster não estão disponíveis ou entram em conflito com os valores reservados do Azure

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

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

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

Causa

Esse problema ocorre porque uma das seguintes condições é verdadeira:

  • O SKU da Máquina Virtual do Azure não está disponível na região selecionada.
  • O principal de serviço é inválido.
  • Uma rede virtual, sub-rede ou tabela de rotas é inválida.
  • Um parâmetro da CLI do Azure é inválido.
  • O valor do nome do parâmetro não está disponível ou é reservado pelo Azure.

Também pode haver outros motivos pelos quais a tentativa de criação do cluster falhou.

Solução

Na tabela a seguir, siga o link para a etapa de solução de problemas apropriada.

Etapa de solução de problemas Link de referência
Verifique se o SKU está disponível Resolva erros para SKU não disponível
Verifique se a entidade de serviço é válida Entidades de serviço junto com o AKS
Verifique se todos os comandos usados para criar o cluster são válidos az aks (referência da CLI do Azure)
Verifique se todos os recursos de rede personalizados que foram usados para criar o cluster são válidos Configurar a rede CNI do Azure no AKS e personalizar a saída do cluster com uma rota definida pelo usuário
Evite usar valores indisponíveis ou reservados pelo Azure para nomes Consulte as mensagens de erro fornecidas

Mais informações

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.