Microsoft Discovery 오류 코드

이 테이블을 사용해 배포, 작업 공간 및 슈퍼컴퓨터 운영, 책장 및 지식 기반 생성, 도구 및 에이전트 실행 시 Microsoft Discovery가 반환하는 오류 코드와 메시지를 조회할 수 있습니다. 상세 내용 열은 원인과 해결 방법을 요약하며, 적용 시 관련 사용법 기사로 연결됩니다.

고유 오류 코드를 반환하지 않을 수 있는 문제에 대해서는 Microsoft Discovery의 알려진 문제를 참조하세요.

특정 코드를 참고하기 전에 다음과 같은 일반적인 점검 사항으로 대부분의 오류를 해결할 수 있습니다:

  • 상관관계 ID를 기록한 후 실패한 작업에서 이를 사용하여 제어부 및 백엔드 로그를 확인합니다. 많은 고장은 요약 오류에 포함되지 않고 운영 기록에서만 완전히 설명됩니다. 활동 로그에서 작업 상관관계 ID 가져오기를 참조하세요.
  • provisioningState를 확인합니다. Succeeded 수술이 완료되었음을 의미하며, Accepted 보통 수술 상태가 진행 중임을 의미하며 Failed , 작업 기록을 확인해야 한다는 의미입니다. 일부 자원 유형은 터미널 Failed 상태에 들어간 후 삭제 후 다시 생성되어야 합니다.
  • 배포를 수행하는 ID의 역할을 확인하세요. 디스커버리는 제어 평면 권한 외에도 데이터 평면, 저장소, 네트워크 경계, 파운드리 권한이 필요합니다. 구독 소유자 만으로는 충분하지 않습니다. Microsoft Discovery의 역할 할당을 참조하세요.
  • 지역과 API 버전을 확인하세요. 지원되는 지역에만 배포하고, 현재 툴박스나 인프라 퀵스타트에 포함된 API 버전을 사용하세요.

REST API 응답 오류

컨트롤 플레인 Azure Resource Manager 요청과 워크스페이스 데이터 플레인 작업 요청은 다음과 같은 HTTP 오류를 반환할 수 있습니다. 다시 시도하기 전에 응답 본문과 상관 ID를 점검하세요.

HTTP 상태 API 또는 오류 코드 해결책
400 제어 평면: InvalidRequestContent 잘못된 요청 본문이나 누락된 필수 속성을 수정하세요. 슈퍼컴퓨터 요청 속성을 참조하세요.
401 데이터 평면: 권한 없음 액세스 토큰을 새로고침하세요.
403 데이터 평면: 금지됨 작업 공간이나 프로젝트에서 호출자의 RBAC 권한을 확인하세요. Project 접근 문제 해결을 참고하세요.
404 컨트롤 플레인: ResourceNotFound 구독, 리소스 그룹, 리소스 ID가 기존 리소스를 식별하는지 확인하세요.
404 데이터 플레인: 찾을 수 없음 프로젝트 이름, 작업 ID 및 작업 영역 URL을 확인하세요.
409 컨트롤 플레인: Conflict 자원 상태를 점검하세요. 예를 들어, 노드 풀을 생성하기 전에 슈퍼컴퓨터의 프로비저닝이 완료될 때까지 기다립니다. 최종 실패 상태의 경우, failed-resource 지침을 사용하세요.
429 TooManyRequests 백오프를 적용하고 다시 시도하세요. 반환되면 Retry-After 헤더를 따르세요.
5xx 데이터 평면: 서버 오류 제한된 지수 백오프로 일시적 실패를 다시 시도하세요. 예를 들어, 작업 API 재시도 전략을 참고하세요.

배포 및 제어 플레인 오류 코드

Code 오류 메시지 Details
AuthorizationFailed The client '<principal>' doesn't have authorization to perform action 'Microsoft.Discovery/...' over scope '...'. If access was recently granted, refresh your credentials. 로그인한 사용자에게 필수 Discovery 플랫폼 역할이 없거나, 최근에 부여된 역할이 토큰에 반영되지 않았습니다. Microsoft Discovery Platform Administrator를 할당하고 자격 증명을 새로고침(로그아웃 후 다시 로그인)하여 새 역할이 토큰에 포함되도록 하세요. Microsoft Discovery의 역할 할당을 참조하세요.
InvalidResourceType Microsoft.Discovery is registered, but the provider metadata doesn't expose the 'supercomputers' or 'storageContainers' resource types. Direct ARM requests return InvalidResourceType for API version <version>. 요청이 지원되지 않는 API 버전이나 지역을 사용하거나, 제공자가 완전히 등록되어 있지 않은 경우입니다. 현재 릴리스의 API 버전과 툴박스 또는 퀵스타트 를 사용하고, 지원되는 지역에 배포한 후 제공자를 재등록하세요. 자원 제공자 등록을 참조하세요.
DeploymentFailed The resource operation completed with terminal provisioning state 'Failed'. 후원 작전은 실패했다. 상관관계 ID를 사용해 배포 작업 이력을 읽고 내부적으로 첫 실패한 작업을 찾아 근본 원인(종종 누락된 역할, 네트워크 기능, 서브넷 또는 할당량 제한)을 해결한 후, 가능하면 부분적으로 생성된 자원을 삭제하지 않고 재시도합니다. 활동 로그에서 작업 상관관계 ID 가져오기를 참조하세요.
ResourceDeploymentFailure The resource provision operation didn't complete successfully. 종속 리소스가 프로비저닝을 하지 못했습니다. 작업 이력에서 실패한 하위 작업을 파악하고 근본 원인을 수정하십시오. 리소스가 터미널 Failed 상태로 남아 재시도할 수 없다면, 실패한 자원만 삭제하고 다시 생성하세요.
InternalServerError The server encountered an internal error. Please retry the request. 생성 또는 업데이트 중 일시적인 백엔드 오류가 발생합니다. 작업을 다시 시도하세요. 문제가 계속된다면, 상관관계 ID를 캡처하고 Azure 지원 요청을 생성하세요.
Conflict The resource is in a 'Failed' state and can't be updated. 터미널 Failed 상태의 리소스는 현장에서 업데이트할 수 없습니다. 실패한 자원만 삭제하고 새 이름과 올바른 전제 조건으로 다시 생성하세요. Microsoft Discovery 작업 공간 관리와 Microsoft Discovery 리소스 삭제를 참조하세요.
RequestDisallowedByPolicy Create or update public IP failed. Resource was disallowed by policy. Azure Policy 할당은 선택한 슈퍼컴퓨터 네트워크 구성에서 요구되는 공인 IP를 거부합니다. 관리되는 공인 IP를 제공하지 않는 지원되는 UserDefinedRouting 구성을 사용하거나, 정책 관리자에게 예외가 허용되는지 문의하세요. Microsoft Discovery의 알려진 문제를 참조하세요.

작업 공간 오류 코드

Code 오류 메시지 Details
InvalidRequest Resources not allowed: storage '<name>' isn't allowlisted in workspace '<workspace>'. 스토리지 계정은 존재하지만 작업 공간과 연관되어 있지 않아서, 해당 참조를 실행하는 도구는 거부됩니다. 스토리지 계정을 작업 공간에 연결한 후 작업을 다시 실행하세요. 'Microsoft 디스커버리 워크스페이스를 관리하기'를 참조하세요.
InvalidRequest Resources not allowed: supercomputer '<name>' isn't allowlisted in workspace '<workspace>'. 슈퍼컴퓨터는 존재하지만 작업 공간과 연관되어 있지 않습니다. 슈퍼컴퓨터를 작업 공간에 연결한 후 도구를 다시 실행하세요. 슈퍼 컴퓨터 관리(Manage Supercomputers)를 참조하세요.
Conflict Workspace is in a terminal 'Failed' state; the operation conflicts with the current state. 정착한 작업 공간만 삭제하고(리소스 그룹, 저장소, 슈퍼컴퓨터는 그대로 두고) 다른 이름으로 다시 만드세요. 고정된 작업 공간에 묶인 슈퍼컴퓨터를 해제하려면, 슈퍼컴퓨터를 삭제하는 대신 작업 공간 내에서 슈퍼컴퓨터 연관성을 제거하세요. 'Microsoft 디스커버리 워크스페이스를 관리하기'를 참조하세요.
QuotaExceeded Workspace creation failed because the container environment quota is insufficient. 워크스페이스의 Azure Container Apps 환경은 생성에 충분한 할당량이 필요합니다. Enterprise SKU의 경우 목표 영역에 최소 80개의 Azure Container Apps 할당 코어를 확보한 후 재시도하세요. 할당량 및 예약을(를) 참조하세요.

슈퍼컴퓨터 오류 코드

Code 오류 메시지 Details
BadRequest UPGRADE FAILED: pre-upgrade hooks failed: Hook pre-upgrade network-operator/templates/keep-ncp-hook.yaml failed: failed calling webhook "mjob.kb.io": ... code 504: 504 Gateway Timeout 슈퍼컴퓨터의 내부 Helm 설치 중 일시적인 오류: kueue-system 네임스페이스의 kueue-webhook-service가 네트워크 운영자 사전 업그레이드 후크에 504를 반환합니다. 슈퍼컴퓨터 개발을 다시 시도하고 최신 플랫폼 버전을 사용하고 있는지 확인하세요. 문제가 지속되면 웹훅 Pod를 점검하세요. 슈퍼컴퓨터 로그 조회를 참조하세요.
NodeNotReady Tool run failed: node became not ready. 노드 풀에서 노드 또는 GPU 드라이버 건강 상태에 문제가 있습니다. 최신 노드 이미지를 사용하고 있는지 확인하고, 비정상 상태가 지속되면 영향을 받은 노드 풀을 다시 생성한 후 실행을 다시 시도하세요. 자동 선택에 의존하지 않고 프로젝트 선호도에서 올바른 노드 풀을 명시적으로 설정하세요. 슈퍼컴퓨터 로그 조회를 참조하세요.
JobTerminated Supercomputer job terminated before completion. AKS가 노드 OS 업그레이드를 수행할 때 장기 실행 작업은 퇴거될 수 있습니다. 작업 및 노드 복원력 개선이 포함된 릴리스를 확인하고, 프로젝트 선호도를 올바르게 설정 nodePoolId 하며, 슈퍼컴퓨터 로그에서 실행 결과를 검토하세요. 작업 실행 디버깅을 참조하세요.

책장 및 지식 기반 오류 코드

Code 오류 메시지 Details
ERR_INCOMPLETE_CHUNKED_ENCODING PATCH .../knowledgeBases/<name>/versions/<version> — 400 (Bad Request). "Failed to create knowledge base." 데이터 플레인은 잘못된 버전 문자열이나 책장 이름을 거부합니다. 긴 문자열 1.0대신에 간단한 정수 버전 번호(예: 1)를 사용하고, 책장명은 소문자와 대시만 사용하도록 하세요. Bookshelf Knowledge Base 색인 생성을(를) 참조하세요.
ResourceCreationValidateFailed Bookshelf creation validation failed (gateway timeout). 책장 생성 중 일시적인 백엔드 타임아웃이 발생합니다. 다시 시도한 후, 생성 작업의 복원력 관련 수정 사항이 포함된 플랫폼 릴리스를 사용 중인지 확인하세요. 재시도하기 전에 해당 지역에 충분한 임베딩 및 검색 모델 할당량이 있는지 확인하세요. 책장 로그 조회를 참조하세요.
IndexingFailed Knowledge base indexing failed. 인덱싱은 매우 큰 단일 문서나 일시적 데이터베이스(SQL) 로그인 타임아웃에서 실패할 수 있습니다. 영향을 받은 문서의 인덱싱 로그를 확인하고, 매우 큰 PDF는 분할하고, 인제스트 개선 사항이 포함된 릴리스를 사용하고 있는지 확인하세요. 큰 문서가 인덱싱이 성공한 것으로 보고되었는데도 답변에 반영되지 않았다면, 조용한 잘림을 의심하고 인덱싱 로그를 확인해 보세요. Bookshelf 인덱싱 로그 조회를 참조하세요.

도구 및 에이전트 오류 코드

Code 오류 메시지 Details
HTTP 500 (파운드리) Project deployment failure: 500 error creating agent in Foundry. 백업 Foundry 리소스에서 에이전트 생성이 실패합니다. 프로젝트의 관리 ID에 Foundry User 역할이 할당되어 있는지 확인하고, 사용자 소유 Cosmos DB의 프라이빗 엔드포인트 연결 및 DNS를 검증하세요. 이미 Failed 상태인 프로젝트는 삭제가 차단될 수 있습니다. 플랫폼 정리 작업을 사용한 후 재배포하세요. 에이전트 생성을 참조하세요.
InvalidMessageId Tool execution failed due to an invalid message id. 에이전트가 도구에 전달하는 잘못된 메시지 식별자나 불일치 신호는 도구가 실행되지 못하게 만듭니다. 메시지 ID 수정과 진단 로그가 포함된 릴리스를 사용 중인지 확인하세요. 추천된 프롬프트 수준의 개선 사항을 적용하고, 에이전트, 워크플로우, 도구 정의를 수집하여 문제를 재현하세요. 작업 실행 디버깅을 참조하세요.
  • 에 마지막으로 업데이트됨