Groups - Add Group User

Service:

Power BI REST APIs

API Version:

v1.0

지정한 사용자에게 지정된 작업 영역에 지정된 권한을 부여합니다.

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Workspace.ReadWrite.All

제한 사항

• 작업 영역에 대한 사용자 권한은 업데이트하는 데 시간이 걸리며 API 호출을 사용할 때 즉시 사용할 수 없습니다. 사용자 권한을 새로 고치려면 사용자 권한 새로 고침 API 호출을 사용합니다.
  
  

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
groupId	path	True	string uuid	작업 영역 ID

요청 본문

Name	필수	형식	Description
groupUserAccessRight	True	GroupUserAccessRight	사용자가 작업 영역에 있는 액세스 권한(권한 수준)
identifier	True	string	보안 주체의 식별자
principalType	True	PrincipalType	보안 주체 유형
displayName		string	보안 주체의 표시 이름
emailAddress		string	사용자의 이메일 주소입니다.
graphId		string	Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
profile		ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.
userType		string	사용자 유형입니다.

응답

Name	형식	Description
200 OK		확인

예제

Assign administrator user access rights to a service principal example

Example

Assign administrator user access rights to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Request Body

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Request Body

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:

200

정의

Name	Description
GroupUser	작업 영역에 액세스할 수 있는 Power BI 사용자
GroupUserAccessRight	사용자가 작업 영역에 있는 액세스 권한(권한 수준)
PrincipalType	보안 주체 유형
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

GroupUser

작업 영역에 액세스할 수 있는 Power BI 사용자

Name	형식	Description
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
groupUserAccessRight	GroupUserAccessRight	사용자가 작업 영역에 있는 액세스 권한(권한 수준)
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.
userType	string	사용자 유형입니다.

GroupUserAccessRight

사용자가 작업 영역에 있는 액세스 권한(권한 수준)

Name	형식	Description
Admin	string	작업 영역 콘텐츠에 대한 관리자 권한
Contributor	string	작업 영역 콘텐츠에 대한 읽기 및 탐색(ReadExplore) 액세스
Member	string	작업 영역 콘텐츠에 대한 읽기, 다시 공유 및 탐색(ReadReshareExplore) 액세스 권한
None	string	작업 영역 콘텐츠에 대한 액세스 권한 없음
Viewer	string	작업 영역 콘텐츠에 대한 읽기 전용(읽기) 액세스

PrincipalType

보안 주체 유형

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

ServicePrincipalProfile

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

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