Share via


Admin - Capacities GetCapacityUsersAsAdmin

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

사용 권한

  • 사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있어야 합니다.
  • 위임된 권한이 지원됩니다.

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

필수 범위

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

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

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
capacityId
path True

string

uuid

용량 ID

응답

Name 형식 Description
200 OK

CapacityUsers

확인

정의

Name Description
CapacityUser

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

capacityUserAccessRight

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

CapacityUsers

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

PrincipalType

보안 주체 유형

ServicePrincipalProfile

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

CapacityUser

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

Name 형식 Description
capacityUserAccessRight

capacityUserAccessRight

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

displayName

string

보안 주체의 표시 이름

emailAddress

string

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

graphId

string

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

identifier

string

보안 주체의 식별자

principalType

PrincipalType

보안 주체 유형

profile

ServicePrincipalProfile

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

userType

string

사용자의 유형입니다.

capacityUserAccessRight

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

Name 형식 Description
Admin

string

사용자에게 용량에 대한 관리자 권한이 있습니다.

Assign

string

사용자에게 기여자 권한이 있으며 용량에 작업 영역을 할당할 수 있습니다.

None

string

사용자에게 용량에 대한 액세스 권한이 없습니다.

CapacityUsers

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

Name 형식 Description
odata.context

string

value

CapacityUser[]

용량에 액세스할 수 있는 사용자 목록

PrincipalType

보안 주체 유형

Name 형식 Description
App

string

서비스 주체 유형

Group

string

그룹 보안 주체 유형

None

string

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

User

string

사용자 계정 유형

ServicePrincipalProfile

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

Name 형식 Description
displayName

string

서비스 주체 프로필 이름

id

string

서비스 주체 프로필 ID