Compartir a través de


Solución de problemas del error InvalidParameter

En este artículo se describe cómo identificar y resolver el InvalidParameter error que se produce al intentar crear e implementar un clúster de Microsoft Azure Kubernetes Service (AKS).

Prerrequisitos

  • CLI de Azure, versión 2.0.81 o posterior. Si la CLI de Azure ya está instalada, puede encontrar el número de versión ejecutando az --version.

Síntomas

Al crear un clúster de AKS, las configuraciones proporcionadas normalmente se validan antes de crear el clúster. Sin embargo, en raras ocasiones, un parámetro pasa la validación antes de crear el clúster de AKS, pero provoca errores cuando se crean los recursos del clúster. Los errores relacionados con parámetros no válidos pueden parecerse a los ejemplos siguientes:

  • Escenario: el tamaño de máquina virtual seleccionado no está 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"
    
  • Escenario: los nombres de clúster no están disponibles o entran en conflicto con los valores reservados de Azure

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

Este problema se produce porque se cumple una de las condiciones siguientes:

  • La SKU de máquina virtual de Azure no está disponible en la región seleccionada.
  • El principal del servicio no es válido.
  • Una tabla de rutas, subred o red virtual no es válida.
  • Un parámetro de la CLI de Azure no es válido.
  • El valor del nombre del parámetro no está disponible o está reservado por Azure.

También puede haber otras razones por las que se produjo un error en el intento de creación del clúster.

Solución

En la tabla siguiente, siga el vínculo para ver el paso de solución de problemas adecuado.

Paso de solución de problemas Vínculo de referencia
Comprobación de si la SKU está disponible Resolución de los errores de no disponibilidad de la SKU
Verifique que la entidad de servicio sea válida Entidades de servicio junto con AKS
Compruebe que los comandos que se usaron para crear el clúster son válidos. az aks (referencia de la CLI de Azure)
Compruebe que los recursos de red personalizados que se usaron para crear el clúster son válidos. Configuración de redes de Azure CNI en AKS y Personalización de la salida del clúster con una ruta definida por el usuario
Evitar el uso de valores no disponibles o reservados de Azure para nombres Consulte los mensajes de error proporcionados.

Información adicional

Ponte en contacto con nosotros para obtener ayuda

Si tiene preguntas, puede preguntar al soporte de la comunidad de Azure. También puede enviar comentarios sobre el producto a la comunidad de comentarios de Azure.