다음을 통해 공유


Admin - Reports GetReportsAsAdmin

organization 대한 보고서 목록을 반환합니다.

사용 권한

  • 사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
  • 위임된 권한이 지원됩니다.

서비스 기본 인증으로 실행하는 경우 앱에는 Azure Portal 설정된 Power BI에 대한 관리자 동의 필수 프리미션이 없어야 합니다.

필수 범위

Tenant.Read.All 또는 Tenant.ReadWrite.All

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련됩니다. 서비스 주체를 통한 인증을 사용할 때는 존재하지 않아야 합니다.

제한 사항

시간당 최대 50개 요청 또는 테넌트당 분당 5개의 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/reports
GET https://api.powerbi.com/v1.0/myorg/admin/reports?$filter={$filter}&$top={$top}&$skip={$skip}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
$filter
query

string

부울 조건에 따라 결과를 필터링합니다.

$skip
query

integer

int32

첫 번째 n 결과 건너뛰기

$top
query

integer

int32

첫 번째 n 결과만 반환합니다.

응답

Name 형식 Description
200 OK

AdminReports

정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/reports

Sample Response

{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com//reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715",
      "workspaceId": "278e22a3-2aee-4057-886d-c3225423bc10"
    }
  ]
}

정의

Name Description
AdminReport

관리 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

AdminReports

Power BI 관리 보고서 컬렉션에 대한 OData 응답 래퍼

PrincipalType

보안 주체 유형

ReportUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

ReportUserAccessRight

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

Subscription

Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)

SubscriptionUser

Power BI 전자 메일 구독 사용자

AdminReport

관리 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name 형식 Description
appId

string

보고서가 앱에 속하는 경우에만 반환되는 앱 ID

createdBy

string

보고서 소유자입니다. 2019년 6월 이후에 생성된 보고서에만 사용할 수 있습니다.

createdDateTime

string

보고서 생성 날짜 및 시간

datasetId

string

보고서의 데이터 세트 ID

description

string

보고서 설명

embedUrl

string

보고서의 포함 URL

id

string

보고서 ID

isOwnedByMe

boolean

현재 사용자가 보고서를 만들었는지 확인합니다.

modifiedBy

string

보고서를 수정한 마지막 사용자

modifiedDateTime

string

보고서가 마지막으로 수정된 날짜 및 시간

name

string

보고서의 이름

originalReportId

string

작업 영역이 앱으로 게시될 때의 실제 보고서 ID입니다.

reportType enum:
  • PaginatedReport
  • PowerBIReport

보고서 유형

subscriptions

Subscription[]

(빈 값) Power BI 항목(예: 보고서 또는 dashboard)에 대한 구독 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다.

users

ReportUser[]

(빈 값) Power BI 보고서에 대한 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 사용자 가져오기를 관리 API 호출로 사용하거나 매개 변수를 사용하여 PostWorkspaceInfo API 호출 getArtifactUsers 을 사용하여 Power BI 보고서에서 사용자 정보를 검색할 수 있습니다.

webUrl

string

보고서의 웹 URL

workspaceId

string

보고서의 작업 영역 ID(GUID)입니다. 이 속성은 GetReportsAsAdmin에서만 반환됩니다.

AdminReports

Power BI 관리 보고서 컬렉션에 대한 OData 응답 래퍼

Name 형식 Description
odata.context

string

OData 컨텍스트

value

AdminReport[]

보고서 컬렉션

PrincipalType

보안 주체 유형

Name 형식 Description
App

string

서비스 주체 유형

Group

string

그룹 보안 주체 유형

None

string

보안 주체 유형이 없습니다. 전체 organization 수준 액세스에 사용합니다.

User

string

사용자 계정 유형

ReportUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

Name 형식 Description
displayName

string

보안 주체의 표시 이름

emailAddress

string

사용자의 이메일 주소입니다.

graphId

string

Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.

identifier

string

보안 주체의 식별자

principalType

PrincipalType

보안 주체 유형

profile

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

reportUserAccessRight

ReportUserAccessRight

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

userType

string

사용자의 유형입니다.

ReportUserAccessRight

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

Name 형식 Description
None

string

보고서의 콘텐츠에 대한 사용 권한 없음

Owner

string

보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여

Read

string

보고서의 콘텐츠에 대한 읽기 액세스 권한 부여

ReadCopy

string

보고서의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여

ReadReshare

string

보고서의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여

ReadWrite

string

보고서의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

Name 형식 Description
displayName

string

서비스 주체 프로필 이름

id

string

서비스 주체 프로필 ID

Subscription

Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)

Name 형식 Description
artifactDisplayName

string

구독된 Power BI 항목의 이름(예: 보고서 또는 dashboard)

artifactId

string

구독된 Power BI 항목의 ID(예: 보고서 또는 dashboard)

artifactType

string

Power BI 항목의 형식(예: Report, Dashboard또는 Dataset)

attachmentFormat

string

전자 메일 구독에 첨부된 보고서의 형식

endDate

string

전자 메일 구독의 종료 날짜 및 시간

frequency

string

전자 메일 구독의 빈도

id

string

구독 ID

isEnabled

boolean

전자 메일 구독을 사용할 수 있는지 여부

linkToContent

boolean

전자 메일 구독에 구독 링크가 있는지 여부

previewImage

boolean

보고서의 스크린샷이 전자 메일 구독에 있는지 여부

startDate

string

전자 메일 구독의 시작 날짜 및 시간

subArtifactDisplayName

string

구독된 Power BI 항목의 페이지 이름(보고서인 경우)입니다.

title

string

앱 이름

users

SubscriptionUser[]

각 전자 메일 구독자의 세부 정보입니다. 사용자 구독 가져오기 관리 API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기 관리 또는 대시보드 구독 가져오기 관리 API 호출을 사용하여 Power BI 보고서 또는 dashboard 구독 정보를 검색할 수 있습니다.

SubscriptionUser

Power BI 전자 메일 구독 사용자

Name 형식 Description
displayName

string

보안 주체의 표시 이름

emailAddress

string

사용자의 이메일 주소입니다.

graphId

string

Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.

identifier

string

보안 주체의 식별자

principalType

PrincipalType

보안 주체 유형

profile

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

userType

string

사용자의 유형입니다.