오류 코드 찾기

ARM 템플릿(Azure Resource Manager 템플릿) 또는 Bicep 파일을 사용한 Azure 리소스 배포에 실패하면 오류 코드가 표시됩니다. 이 문서에서는 문제를 해결할 수 있도록 오류 코드를 찾는 방법에 대해 설명합니다. 오류 코드에 대한 자세한 내용은 일반적인 배포 오류를 참조하세요.

오류 유형

배포와 관련된 세 가지 유형의 오류가 있습니다.

  • 검증 오류는 배포가 시작되기 전에 발생하며 파일의 구문 오류로 인해 발생합니다. 편집기에서 이러한 오류를 식별할 수 있습니다.
  • 배포 명령이 실행되지만 리소스가 배포되지 않은 경우 실행 전 유효성 검사 오류가 발생합니다. 이러한 오류는 배포를 시작하지 않고 발견됩니다. 예를 들어 매개 변수 값이 잘못된 경우 실행 전 유효성 검사에서 오류가 발견됩니다.
  • 배포 오류는 배포 프로세스 중에 발생하며 배포 진행 상황을 평가해야만 찾을 수 있습니다.

모든 오류 유형에서 배포 문제를 해결하는 데 사용하는 오류 코드를 반환합니다. 유효성 검사 및 실행 전 오류는 활동 로그에 표시되지만 배포 기록에는 표시되지 않습니다. 구문 오류가 있는 Bicep 파일은 JSON으로 컴파일되지 않으며 활동 로그에 표시되지 않습니다.

구문 오류를 식별하기 위해 최신 Bicep 확장 또는 Azure Resource Manager Tools 확장과 함께 Visual Studio Code를 사용할 수 있습니다.

유효성 검사 오류

배포 프로세스 중에 템플릿의 유효성이 검사되고 오류 코드가 표시됩니다. 배포를 실행하기 전에 Azure PowerShell 또는 Azure CLI에서 유효성 검사 테스트를 실행하여 유효성 검사 및 실행 전 오류를 식별할 수 있습니다.

ARM 템플릿은 포털에서 배포할 수 있습니다. 템플릿에 구문 오류가 있는 경우 배포를 실행하려고 하면 유효성 검사 오류가 표시됩니다. 포털 배포에 대한 자세한 내용은 사용자 지정 템플릿에서 리소스 배포를 참조하세요.

다음 예에서는 스토리지 계정을 배포하려고 시도하고 유효성 검사 오류가 발생합니다.

Screenshot of an Azure portal validation error.

메시지를 선택하여 세부 정보를 확인합니다. 템플릿에 오류 코드가 InvalidTemplate인 구문 오류가 있습니다. 요약에서 식에 닫는 괄호가 없음을 보여 줍니다.

Screenshot of a validation error message that shows a syntax error.

배포 오류

여러 작업이 Azure 리소스를 배포하기 위해 처리됩니다. 작업이 유효성 검사를 통과하지만 배포 중에 실패하면 배포 오류가 발생합니다. 리소스 그룹에 대한 각 배포 작업 및 각 배포에 대한 메시지를 볼 수 있습니다.

배포 작업에 대한 메시지를 확인하려면 리소스 그룹의 활동 로그를 사용합니다.

  1. Azure 포털에 로그인합니다.

  2. 리소스 그룹으로 이동하여 배포의 리소스 그룹 이름을 선택합니다.

  3. 활동 로그를 선택합니다.

  4. 필터를 사용하여 작업의 오류 로그를 찾습니다.

    Screenshot of the resource group's activity log that highlights a failed deployment.

  5. 오류 로그를 선택하여 작업 세부 정보를 확인합니다.

    Screenshot of the activity log details that shows a failed deployment's error message.

배포 결과를 확인하려면 다음을 수행합니다.

  1. 리소스 그룹으로 이동합니다.

  2. 설정배포를 차례로 선택합니다.

  3. 배포에 대한 오류 세부 정보를 선택합니다.

    Screenshot of a resource group's link to error details for a failed deployment.

  4. 오류 메시지 및 NoRegisteredProviderFound 오류 코드가 표시됩니다.

    Screenshot of a message that shows deployment error details.

다음 단계