Admin - Capacities GetCapacityUsersAsAdmin

서비스:

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/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 Graph의 보안 주체 식별자입니다. 관리자 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