다음을 통해 공유

REST API 문제 해결

  • 아티클

401을 반환하는 API 호출

추가 조사를 위해 Fiddler 캡처가 필요할 수 있습니다. Microsoft Entra ID 내에 등록된 애플리케이션에 필요한 권한 범위가 누락되었을 수 있습니다. Azure Portal 내의 Microsoft Entra ID에 대한 앱 등록 내에 필요한 범위가 있는지 확인합니다.

403을 반환하는 API 호출

403 오류는 다음 이유로 발생할 수 있습니다. 추가 조사를 위해 Fiddler 캡처가 필요할 수 있습니다.

  • 사용자가 공유 용량에 생성될 수 있는 포함 토큰의 양을 초과했습니다. Azure 용량을 구입하여 포함 토큰을 생성하고 해당 용량에 작업 영역을 할당합니다. Azure Portal에서 Power BI Embedded 용량 만들기를 참조하세요.
  • Microsoft Entra 권한 부여 토큰이 만료되었습니다.
  • 인증된 사용자가 그룹(작업 영역)의 구성원이 아닙니다.
  • 인증된 사용자가 그룹(작업 영역)의 관리자가 아닙니다.
  • 인증된 사용자에게 권한이 없습니다. 사용 권한은 refreshUserPermissions API를 사용하여 업데이트할 수 있습니다.
  • 권한 부여 헤더가 올바르게 표시되지 않을 수 있습니다. 오타가 없는지 확인합니다.

GenerateToken을(를) 호출하기 전에 애플리케이션의 백 엔드에서 권한 부여 토큰을 새로 고쳐야 할 수 있습니다. 자세한 내용은 액세스 토큰 새로 고침을 참조하세요.

GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...

HTTP/1.1 403 Forbidden
...

{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}

가져오기 및 내보내기 API를 사용할 때 시간 초과 예외 수정

Power BI REST API 요청을 보낼 때 테넌트의 데이터를 포함하지 않는 클러스터에 요청이 도착할 수 있습니다. 이러한 경우 요청 리디렉션이 시간 초과로 인해 실패할 수 있습니다.

시간 초과 예외를 해결하려면 preferClientRouting URL 쿼리 매개 변수가 true(으)로 설정된 요청을 다시 전송하세요. 요청이 잘못된 클러스터에 도착하면 Power BI 서비스는 ‘307 임시 리디렉션’ HTTP 응답을 반환합니다. 이 경우 응답 ‘HTTPS 위치 헤더’에 지정된 새 주소로 요청을 리디렉션해야 합니다.

몇 분 후에 업데이트 매개 변수 또는 업데이트 데이터 원본 API가 실패합니다.

응답 헤더에 다음과 같은 제네릭 오류가 반환되는 경우가 있습니다.

HTTP/1.1 500 Internal Server Error

An error has occurred

데이터 세트 - 그룹의 매개 변수 업데이트 또는 데이터 세트 - 그룹에서 데이터 원본 업데이트 API를 사용하는 경우 이 오류는 큰 데이터 세트 형식을 사용하지 않는 큰 데이터 세트를 업데이트하고 있음을 나타낼 수 있습니다. 큰 데이터 세트 형식을 사용하여 오류를 방지합니다.

관련 콘텐츠

Power BI Embedded에 대한 질문과 대답

추가 질문이 있으신가요? Power BI 커뮤니티에 문의