排查 InvalidParameter 错误

本文介绍如何识别和解决InvalidParameter尝试创建和部署 Microsoft Azure Kubernetes 服务 （AKS） 群集时发生的错误。

先决条件

• Azure CLI 版本 2.0.81 或更高版本。 如果已安装 Azure CLI，可以通过运行 az --version找到版本号。

现象

创建 AKS 群集时，提供的配置通常在创建群集之前进行验证。 但是，在极少数情况下，参数在创建 AKS 群集之前通过验证，但在创建群集的资源时会导致错误。 与无效参数相关的错误可能类似于以下示例：

• 方案：所选 VM 大小不可用

  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"
  

• 方案：群集名称不可用或与 Azure 保留值冲突

  • 示例 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."
    

  • 示例 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."
    

  • 示例 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"
    

原因

出现此问题的原因是以下条件之一为 true：

• Azure 虚拟机 SKU 在所选区域中不可用。
• 服务主体无效。
• 虚拟网络、子网或路由表无效。
• Azure CLI 参数无效。
• 参数名称的值不可用或由 Azure 保留。

群集创建尝试失败还有其他原因。

解决方案

在下表中，按照相应的故障排除步骤链接操作。

故障排除步骤	参考链接
检查 SKU 是否可用	解决 SKU 不可用的错误
验证服务主体是否有效	服务主体与 AKS
验证用于创建群集的任何命令是否有效	az aks （Azure CLI 参考）
验证用于创建群集的任何自定义网络资源是否有效	在 AKS 中配置 Azure CNI 网络，并使用 用户定义的路由自定义群集出口
避免对名称使用不可用或 Azure 保留的值	请参阅提供的错误消息

详细信息

• AKS 群集创建问题的常规故障排除

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 你还可以将产品反馈提交到 Azure 反馈社区。