Power BI Report Server용 REST API를 사용하여 개발

Power BI Report Server는 REST(표현 상태 전송) API를 지원합니다. REST API는 보고서 서버 내의 리소스에 대한 만들기, 검색, 업데이트 또는 삭제 액세스를 제공하는 일련의 HTTP 작업(메서드)을 지원하는 서비스 엔드포인트입니다.

REST API는 Power BI Report Server 카탈로그의 개체에 프로그래밍 방식으로 액세스할 수 있도록 합니다. 개체의 예로는 폴더, 보고서, KPI, 데이터 원본, 데이터 세트, 새로 고침 계획, 구독 등이 있습니다. 예를 들어 REST API를 사용하여 폴더 계층 구조를 탐색하거나, 폴더의 내용을 검색하거나, 보고서 정의를 다운로드할 수 있습니다. 개체를 만들고, 업데이트하고, 삭제할 수도 있습니다. 개체 작업의 예로는 보고서 업로드, 새로 고침 계획 실행, 폴더 삭제 등이 있습니다.

REST API 요청/응답의 구성 요소

REST API 요청/응답 쌍은 다음 다섯 가지 구성 요소로 구분할 수 있습니다.

• 다음으로 구성된 요청 URI입니다 {URI-scheme} :// {URI-host} / {resource-path} ? {query-string}. 요청 URI는 요청 메시지 헤더에 포함되어 있지만 대부분의 언어 또는 프레임워크에서 요청 메시지와 별도로 전달해야 하기 때문에 여기서는 별도로 호출합니다.

  • URI 체계: 요청을 전송하는 데 사용되는 프로토콜을 나타냅니다. 예를 들어 http 또는 https.
  • URI 호스트: REST 서비스 엔드포인트가 호스트되는 서버의 도메인 이름 또는 IP 주소를 지정합니다(예: myserver.contoso.com.).
  • 리소스 경로: 리소스 또는 리소스 컬렉션을 지정합니다. 이 컬렉션은 서비스에서 해당 리소스의 선택을 결정하는 데 사용하는 여러 세그먼트를 포함할 수 있습니다. 예를 들어 CatalogItem CatalogItems(01234567-89ab-cdef-0123-456789abcdef)/Properties 에 대해 지정된 속성을 가져오는 데 사용할 수 있습니다.
  • 쿼리 문자열(선택 사항): API 버전 또는 리소스 선택 조건과 같은 다른 간단한 매개 변수를 제공합니다.

• HTTP 요청 메시지 헤더 필드:

  • 필요한 HTTP 메서드 (작업 또는 동사라고도 함)는 요청하는 작업의 유형을 서비스에 알려줍니다. Reporting Services REST API는 DELETE, GET, HEAD, PUT, POST 및 PATCH 메서드를 지원합니다.
  • 지정된 URI 및 HTTP 메서드에 필요한 다른 선택적 헤더 필드입니다.

• URI 및 HTTP 작업을 지원하기 위한 선택적 HTTP 요청 메시지 본문 필드입니다. 예를 들어 POST 작업에는 복잡한 매개 변수로 전달되는 MIME로 인코딩된 개체가 포함됩니다. POST 또는 PUT 작업의 경우 요청 헤더에도 본문에 대한 MIME 인코딩 형식을 Content-type 지정해야 합니다. 일부 서비스에서는 특정 MIME 형식(예: application/json.)을 사용해야 합니다.

• HTTP 응답 메시지 헤더 필드:

  • 2xx 성공 코드에서 4xx 또는 5xx 오류 코드에 이르는 HTTP 상태 코드입니다. 또는 API 설명서에 표시된 대로 서비스 정의 상태 코드가 반환될 수 있습니다.
  • 다른 선택적 헤더 필드로, 요청의 응답을 지원하는 데 필요합니다. 예를 들어 Content-type 응답 헤더가 있습니다.

• 선택적 HTTP 응답 메시지 본문 필드:

  • MIME로 인코딩된 응답 개체는 데이터를 반환하는 GET 메서드의 응답과 같이 HTTP 응답 본문에 반환됩니다. 일반적으로 이러한 개체는 응답 헤더에 표시된 대로 JSON 또는 XML과 같은 구조화된 형식으로 반환됩니다 Content-type .

API 설명서

최신 REST API는 최신 API 설명서를 요구합니다. REST API는 OpenAPI 사양(swagger 사양이라고도 함)을 기반으로 하며 Microsoft Learn에서 설명서를 사용할 수 있습니다.

API 호출 테스트

HTTP 요청/응답 메시지를 테스트하는 도구는 Fiddler입니다. Fiddler는 REST 요청을 가로챌 수 있는 무료 웹 디버깅 프록시이므로 HTTP 요청/응답 메시지를 쉽게 진단할 수 있습니다.

관련 콘텐츠

Microsoft Learn에서 사용 가능한 API를 검토합니다.

샘플은 GitHub에서 사용할 수 있습니다. 이 샘플에는 PowerShell 예제와 함께 TypeScript, React 및 webpack을 기반으로 빌드된 HTML5 앱이 포함되어 있습니다.

더 많은 질문? Power BI 커뮤니티에 문의해 보세요.