다음을 통해 공유

Groups - Add Group User

서비스:
Power BI REST APIs
API 버전:
v1.0

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

권한

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

필수 범위

Workspace.ReadWrite.All

제한점

  • 작업 영역에 대한 사용자 권한은 업데이트하는 데 시간이 걸리며 API 호출을 사용할 때 즉시 사용할 수 없습니다. 사용자 권한을 새로 고치려면 사용자 권한 새로 고침 API 호출을 사용합니다.
  • 각 작업 영역은 작업 영역 역할(관리자, 멤버, 참가자, 뷰어)에서 최대 1,000명의 사용자 또는 그룹으로 제한됩니다. 그룹 내의 사용자 수는 제한되지 않습니다. 이 제한 사항에는 외부 게스트도 적용됩니다. 

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

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
요청 본문
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

샘플 응답

상태 코드:
200

Example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
요청 본문
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

샘플 응답

상태 코드:
200

정의

Name Description
GroupUser

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

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

보안 주체 형식
ServicePrincipalProfile

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

GroupUser

Object

작업 영역에 액세스할 수 있는 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

열거형

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

값 Description
None

작업 영역 콘텐츠에 대한 액세스 권한 없음
Member

작업 영역 콘텐츠에 대한 읽기, 다시 공유 및 탐색(ReadReshareExplore) 액세스 권한
Admin

작업 영역 콘텐츠에 대한 관리자 권한
Contributor

작업 영역 콘텐츠에 대한 읽기 및 탐색(ReadExplore) 액세스
Viewer

작업 영역 콘텐츠에 대한 읽기 전용(읽기) 액세스

PrincipalType

열거형

보안 주체 형식

값 Description
None

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

사용자 계정 유형
Group

그룹 보안 주체 유형
App

서비스 주체 유형

ServicePrincipalProfile

Object

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

Name 형식 Description
displayName

string

서비스 주체 프로필 이름
id

string (uuid)

서비스 주체 프로필 ID