Admin - Apps GetAppUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

지정된 앱에 액세스할 수 있는 사용자 목록을 반환합니다.

사용 권한

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

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

필수 범위

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

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련이 있습니다. 서비스 주체를 통한 인증을 사용할 때는 없어야 합니다.

제한 사항

시간당 최대 200개 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
appId	path	True	string uuid	앱 ID

응답

Name	형식	Description
200 OK	AppUsers	확인

예제

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

정의

Name	Description
AppUser	앱에 대한 Power BI 사용자 액세스 권한 항목
AppUserAccessRight	사용자가 앱에 대해 가지고 있는 액세스 권한
AppUsers	앱에 액세스할 수 있는 Power BI 사용자 목록의 OData 응답 래퍼
PrincipalType	보안 주체 유형

AppUser

앱에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
appUserAccessRight	AppUserAccessRight	사용자가 앱에 대해 가지고 있는 액세스 권한
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft 그래프의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형

AppUserAccessRight

사용자가 앱에 대해 가지고 있는 액세스 권한

Name	형식	Description
All	string	앱에서 콘텐츠에 대한 읽기, 쓰기, 탐색, 다시 공유 및 복사 액세스 권한 부여
None	string	앱의 콘텐츠에 대한 사용 권한 없음
Read	string	앱의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadCopy	string	앱의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadExplore	string	앱의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadExploreCopy	string	앱에서 콘텐츠에 대한 읽기, 탐색 및 복사 액세스 권한 부여
ReadReshare	string	앱의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareCopy	string	앱에서 콘텐츠에 대한 읽기, 다시 공유 및 복사 액세스 권한 부여
ReadReshareExplore	string	앱에서 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadReshareExploreCopy	string	앱에서 콘텐츠에 대한 읽기, 다시 공유, 탐색 및 복사 액세스 권한 부여
ReadWrite	string	앱의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore	string	앱의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteExploreCopy	string	앱에서 콘텐츠에 대한 읽기, 쓰기, 탐색 및 복사 액세스 권한 부여
ReadWriteReshare	string	앱의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore	string	앱의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

AppUsers

앱에 액세스할 수 있는 Power BI 사용자 목록의 OData 응답 래퍼

Name	형식	Description
odata.context	string
value	AppUser[]	앱에 액세스할 수 있는 사용자 목록

PrincipalType

보안 주체 유형

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