次の方法で共有

InvalidParameter エラーのトラブルシューティング

この記事では、Microsoft Azure Kubernetes Service (AKS) クラスターを作成してデプロイしようとしたときに発生する InvalidParameter エラーを特定して解決する方法について説明します。

[前提条件]

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

原因

この問題は、次のいずれかの条件に該当するため発生します。

  • Azure 仮想マシン SKU は、選択したリージョンでは使用できません。
  • サービス プリンシパルが無効です。
  • 仮想ネットワーク、サブネット、またはルート テーブルが無効です。
  • Azure CLI パラメーターが無効です。
  • パラメーター名の値は使用できないか、Azure によって予約されています。

クラスターの作成が失敗した他の理由もあります。

解決策

次の表で、適切なトラブルシューティング手順のリンクに従います。

トラブルシューティングの手順 参照リンク
SKU が使用可能かどうかを確認する SKU 利用不可エラーを解決する
サービス プリンシパルが有効であることを確認する サービス プリンシパルと AKS
クラスターの作成に使用されたすべてのコマンドが有効であることを確認します az aks (Azure CLI リファレンス)
クラスターの作成に使用されたカスタム ネットワーク リソースが有効であることを確認します AKS で Azure CNI ネットワークを構成し ユーザー定義ルートを使用してクラスター エグレスを カスタマイズする
名前に使用できない値または Azure で予約された値を使用しないようにする 提供されたエラー メッセージを参照してください

詳細情報

お問い合わせはこちらから

ご質問がある場合は、 Azure コミュニティサポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。

  • Last updated on