다음을 통해 공유

InvalidParameter 오류 문제 해결

이 문서에서는 AKS(Microsoft Azure Kubernetes Service) 클러스터를 만들고 배포하려고 할 때 발생하는 오류를 식별하고 해결하는 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"

원인

이 문제는 다음 조건 중 하나가 true이므로 발생합니다.

  • Azure Virtual Machine SKU는 선택한 지역에서 사용할 수 없습니다.
  • 서비스 주체가 잘못되었습니다.
  • 가상 네트워크, 서브넷 또는 경로 테이블이 잘못되었습니다.
  • Azure CLI 매개 변수가 잘못되었습니다.
  • 매개 변수 이름의 값을 사용할 수 없거나 Azure에서 예약할 수 없습니다.

클러스터 만들기 시도가 실패한 다른 이유가 있을 수도 있습니다.

해결 방법

다음 표에서 적절한 문제 해결 단계에 대한 링크를 따릅니다.

문제 해결 단계 참조 링크
SKU를 사용할 수 있는지 확인 SKU 사용할 수 없음 오류 해결
서비스 주체가 유효한지 확인 서비스 주체와 AKS
클러스터를 만드는 데 사용된 명령이 유효한지 확인합니다. az aks (Azure CLI 참조)
클러스터를 만드는 데 사용된 사용자 지정 네트워크 리소스가 유효한지 확인합니다. AKS 에서 Azure CNI 네트워킹 구성 및 사용자 정의 경로를 사용하여 클러스터 송신 사용자 지정
이름에 사용할 수 없거나 Azure 예약 값을 사용하지 않도록 방지 제공된 오류 메시지를 참조하세요.

추가 정보

도움을 요청하십시오.

질문이 있는 경우 Azure 커뮤니티 지원을 요청할 수 있습니다. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.

  • Last updated on