Admin - Reports GetReportsInGroupAsAdmin

참조

서비스:: Power BI REST APIs

API 버전:: v1.0

지정된 작업 영역에서 보고서 목록을 반환합니다.

권한

사용자는 패브릭 관리자이거나 서비스 주체를 사용하여 인증해야 합니다.
위임된 권한이 지원됩니다.

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

필수 범위

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

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

제한점

시간당 최대 200개 요청

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/reports

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
groupId	path	True	string (uuid)	작업 영역 ID
$filter	query		string	Odata 필터 쿼리 매개 변수 조건에 따라 결과의 하위 집합을 반환합니다.
$skip	query		integer (int32)	첫 번째 n 결과를 건너뜁니다.
$top	query		integer (int32)	첫 번째 n 결과만 반환합니다.

응답

Name	형식	Description
200 OK	AdminReports	그래

예제

Example

샘플 요청

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48"
    }
  ]
}

정의

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 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드)
SubscriptionUser	Power BI 전자 메일 구독 사용자

AdminReport

Object

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

Name	형식	Description
appId	string	보고서가 앱에 속하는 경우에만 반환되는 앱 ID입니다.
createdBy	string	보고서 소유자입니다. 2019년 6월 이후에 생성된 보고서에만 사용할 수 있습니다.
createdDateTime	string (date-time)	보고서 생성 날짜 및 시간
datasetId	string	보고서의 데이터 세트 ID
description	string	보고서 설명
embedUrl	string	보고서의 포함 URL
id	string (uuid)	보고서 ID
isOwnedByMe	boolean	현재 사용자에게 보고서의 복사본을 수정하거나 만들 수 있는지 여부를 나타냅니다.
modifiedBy	string	보고서를 수정한 마지막 사용자
modifiedDateTime	string (date-time)	보고서가 마지막으로 수정된 날짜 및 시간입니다.
name	string	보고서의 이름 앱 보고서는 접두사 [앱]으로 시작합니다.
originalReportId	string (uuid)	작업 영역이 앱으로 게시될 때의 실제 보고서 ID입니다.
reportType	enum: PaginatedReport PowerBIReport	보고서 형식
subscriptions	Subscription[]	(빈 값) Power BI 항목(예: 보고서 또는 대시보드)에 대한 구독 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리자 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다.
users	ReportUser[]	(빈 값) Power BI 보고서에 대한 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 사용자를 관리자 API 호출로 가져오기 또는 매개 변수를 사용하여 `getArtifactUsers` API 호출을 사용하여 Power BI 보고서에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	보고서의 웹 URL
workspaceId	string (uuid)	보고서의 GUID(작업 영역 ID)입니다. 이 속성은 GetReportsAsAdmin에서만 반환됩니다.

AdminReports

Object

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

Name	형식	Description
@odata.context	string	OData 컨텍스트
value	AdminReport[]	보고서 컬렉션

PrincipalType

열거형

보안 주체 형식

값	Description
App	서비스 주체 유형
Group	그룹 보안 주체 유형
None	보안 주체 형식이 없습니다. 전체 조직 수준 액세스에 사용합니다.
User	사용자 계정 유형

ReportUser

Object

보고서에 대한 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

열거형

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

값	Description
None	보고서의 콘텐츠에 대한 사용 권한 없음
Owner	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	보고서의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadCopy	보고서의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	보고서의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	보고서의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

ServicePrincipalProfile

Object

Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.

Name	형식	Description
displayName	string	서비스 주체 프로필 이름
id	string (uuid)	서비스 주체 프로필 ID

Subscription

Object

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

Name	형식	Description
artifactDisplayName	string	구독된 Power BI 항목의 이름(예: 보고서 또는 대시보드)
artifactId	string (uuid)	구독된 Power BI 항목의 ID(예: 보고서 또는 대시보드)
artifactType	string	Power BI 항목의 형식(예: `Report`, `Dashboard`또는 `Dataset`)
attachmentFormat	string	전자 메일 구독에 첨부된 보고서의 형식
endDate	string (date-time)	전자 메일 구독의 종료 날짜 및 시간
frequency	string	전자 메일 구독의 빈도
id	string (uuid)	구독 ID
isEnabled	boolean	전자 메일 구독을 사용할 수 있는지 여부
linkToContent	boolean	전자 메일 구독에 구독 링크가 있는지 여부
previewImage	boolean	보고서의 스크린샷이 전자 메일 구독에 있는지 여부
startDate	string (date-time)	전자 메일 구독의 시작 날짜 및 시간
subArtifactDisplayName	string	구독된 Power BI 항목의 페이지 이름(보고서인 경우)입니다.
title	string	앱 이름
users	SubscriptionUser[]	각 전자 메일 구독자의 세부 정보입니다. User Subscriptions As Admin API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독을 관리자로 가져오기 사용하거나 대시보드 구독을 관리자로 API 호출을 사용하여 Power BI 보고서 또는 대시보드에서 구독 정보를 검색할 수 있습니다.

SubscriptionUser

Object

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	사용자의 유형입니다.

다음을 통해 공유

Admin - Reports GetReportsInGroupAsAdmin

권한

필수 범위

제한점

URI 매개 변수

응답

예제

Example

샘플 요청

샘플 응답

정의

AdminReport

AdminReports

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser