Edit

Share via

Troubleshoot InvalidParameter error

This article discusses how to identify and resolve the InvalidParameter error that occurs when you try to create and deploy a Microsoft Azure Kubernetes Service (AKS) cluster.

Prerequisites

  • Azure CLI, version 2.0.81 or a later version. If Azure CLI is already installed, you can find the version number by running az --version.

Symptoms

When you create an AKS cluster, the provided configurations are usually validated before the cluster is created. However, on rare occasions, a parameter passes validation before the AKS cluster is created but causes errors when the resources for the cluster are created. Errors that are related to invalid parameters might resemble the following examples:

  • Scenario: The selected VM size is not available

    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: Cluster names are unavailable or conflict with Azure reserved values

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

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

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

Cause

This issue occurs because one of the following conditions is true:

  • The Azure Virtual Machine SKU isn't available in the selected region.
  • The service principal is invalid.
  • A virtual network, subnet, or route table is invalid.
  • An Azure CLI parameter is invalid.
  • The value of parameter name is unavailable or reserved by Azure.

There might also be other reasons that your cluster creation attempt failed.

Solution

In the following table, follow the link for the appropriate troubleshooting step.

Troubleshooting step Reference link
Check whether the SKU is available Resolve errors for SKU not available
Verify that the service principal is valid Service principals together with AKS
Verify that any commands that were used to create the cluster are valid az aks (Azure CLI reference)
Verify that any custom network resources that were used to create the cluster are valid Configure Azure CNI networking in AKS and Customize cluster egress with a user-defined route
Avoid using unavailable or Azure-reserved values for names Refer to the error messages provided

More information

Contact us for help

If you have questions or need help, create a support request, or ask Azure community support. You can also submit product feedback to Azure feedback community.