Power BI REST API 사용

아티클
02/05/2025

Power BI REST API는 포함, 관리, 거버넌스 및 사용자 리소스를 위한 서비스 엔드포인트를 제공합니다.

Power BI REST API를 사용하여 다음을 수행할 수 있습니다.

Power BI 콘텐츠 관리
관리자 작업 수행
Power BI 콘텐츠 포함

메모

일부 Power BI API는 작업 영역을 그룹으로 참조합니다. 그룹에 대한 참조는 작업 영역을 사용 중임을 의미합니다.
Power BI REST API에 액세스할 때 요청 및 응답 콘텐츠 및 데이터는 Power BI 테넌트 홈 지역이 아닌 지역의 데이터 센터에서 처리될 수 있습니다.

범위

Power BI REST API를 사용하려면 Azure AD(Azure Active Directory) 애플리케이션을 Azure에 등록해야 합니다. Azure AD 앱은 Power BI REST 리소스에 대한 권한을 설정하고 Power BI REST API에 대한 액세스를 허용합니다. 앱을 등록하는 방법을 알아보려면 Power BI 사용할 Azure AD 애플리케이션 등록참조하세요.

Azure AD 앱을 등록한 후 Azure AD(v1.0; 중 하나를 사용하여 인증할 수 있습니다. ADAL) 또는 Microsoft ID 플랫폼(v2.0; MSAL) 엔드포인트. 이러한 인증 방법의 작동 방식에 대한 자세한 내용은 Microsoft ID 플랫폼(v2.0)으로 업데이트하는 이유를 참조하세요.

Power BI 액세스 권한에 대한 자세한 내용은 Microsoft ID 플랫폼 엔드포인트 권한 및 동의를 참조하세요.

서비스 주체 사용

서비스 주체사용하는 경우에는 범위가 필요하지 않습니다. Power BI에서 서비스 주체를 사용하도록 설정하면 애플리케이션의 AD 권한이 더 이상 적용되지 않습니다. 서비스 주체를 사용하는 경우 애플리케이션의 권한은 Power BI 관리 포털을 통해 관리됩니다. 자세한 내용은 Power BI 서비스 관리자 설정 사용참조하세요.

범위 추가

Azure AD 앱에 권한을 추가하려면 다음 단계를 수행합니다.

Azure에서 앱을 엽니다.
왼쪽의 관리아래에서 API 권한을 선택합니다.
사용 권한 추가선택합니다.
요청 API 권한 창에서 Power BI 서비스 선택합니다.
위임된 권한 선택합니다. API 목록이 표시됩니다.
사용 권한을 추가하려는 API를 확장하고 추가하려는 권한을 선택합니다.
사용 권한 추가를 선택합니다.

범위 제거

Azure AD 앱에서 권한을 제거하려면 다음 단계를 수행합니다.

Azure에서 앱을 엽니다.
왼쪽의 관리아래에서 API 권한을 선택합니다.
상황에 맞는 메뉴(권한 줄임표)를 선택합니다.
사용 권한 제거를 선택합니다.

제한

Power BI는 제한을 사용하여 최적의 성능과 안정성을 유지합니다. 단일 사용자의 리소스를 과도하게 사용하는 것을 방지하기 위해 Power BI는 사용자당 시간 범위 내에서 API 호출 수를 제한합니다.

사용자가 일정 기간 동안 미리 정해진 제한을 초과하는 여러 요청을 보내면 Power BI는 짧은 기간 동안 해당 사용자의 추가 요청을 제한합니다.

애플리케이션에 제한이 발생하면 Power BI는 응답에 Retry-After HTTP 헤더가 있는 HTTP 상태 코드 429(요청이 너무 많음)를 반환하며, 이는 호출 애플리케이션이 새 요청을 만들기 전에 대기해야 하는 시간(초)을 나타냅니다.

지리적 지역 간 다운로드

호출이 실행된 지역과 다른 지역에서 파일을 다운로드하는 작업이 예상보다 오래 걸릴 수 있습니다.

REST 작업 그룹

이 표에는 Power BI REST API 작업 그룹이 나열됩니다.

메모

Power BI Embedded 용량을 관리하려면 Power BI Embedded Azure Resource Manager REST API사용합니다.

작업 그룹	묘사
관리자	관리 작업을 위한 작업입니다.
앱	앱 작업을 위한 작업입니다.
사용 가능한 기능	사용 가능한 기능을 반환하는 작업입니다.
용량	용량 작업을 위한 작업입니다.
대시보드	대시보드 작업을 위한 작업입니다.
데이터 흐름 스토리지 계정	데이터 흐름 스토리지 계정 작업을 위한 작업입니다.
데이터 흐름	데이터 흐름 작업에 대한 작업입니다.
데이터 세트	데이터 세트 작업을 위한 작업입니다.
토큰 포함	포함 토큰 작업을 위한 작업입니다.
게이트웨이	게이트웨이 작업을 위한 작업입니다.
그룹	그룹으로 작업하기 위한 작업입니다.
가져오기	가져오기 작업을 위한 작업입니다.
파이프라인	배포 파이프라인 작업을 위한 작업입니다.
푸시 데이터 세트	푸시 데이터 세트 작업을 위한 작업입니다.
보고서	보고서 작업을 위한 작업입니다.
템플릿 앱	템플릿 앱 작업을 위한 작업입니다.
사용자	사용자 작업을 위한 작업입니다.

다음 단계

플레이그라운드

Power BI 임베디드 분석 설명서

.NET SDK

다음을 통해 공유