다음을 통해 공유


Power BI REST API 사용

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에 Azure Active Directory(Azure AD) 애플리케이션을 등록해야 합니다. 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 앱에 권한을 추가하려면 다음 단계를 수행합니다.

  1. Azure에서 앱을 엽니다.

  2. 왼쪽의 관리에서 API 권한을 선택합니다.

  3. 사용 권한 추가를 선택합니다.

  4. API 권한 요청 창에서 Power BI 서비스를 선택합니다.

  5. 위임된 권한을 선택합니다. API 목록이 표시됩니다.

  6. 사용 권한을 추가하려는 API를 확장하고 추가하려는 권한을 선택합니다.

  7. 권한 추가를 선택합니다.

범위 제거

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

  1. Azure에서 앱을 엽니다.

  2. 왼쪽의 관리에서 API 권한을 선택합니다.

  3. 상황에 맞는 메뉴(권한 줄임표)를 선택합니다.

  4. 권한 제거를 선택합니다.

제한

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를 사용합니다.

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

다음 단계