Datasets - Post Dataset User In Group

Service:

Power BI REST APIs

API Version:

v1.0

지정된 데이터 세트에 지정된 사용자의 권한을 부여합니다.

데이터 세트에 대한 사용자 권한이 최근에 업데이트된 경우 API 호출을 통해 새 권한을 즉시 사용할 수 없을 수 있습니다. 사용자 권한을 새로 고치려면 사용자 권한 새로 고침 API 호출을 사용합니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

• 서비스 주체에 사용 권한 추가(앱 principalType)는 지원되지 않습니다.
• 호출자에게 데이터 세트에 대한 ReadReshare 권한이 있어야 합니다.
• 이 API 호출은 데이터 세트에 대한 데이터 세트 쓰기 권한을 부여하는 데 사용할 수 없습니다.
  
  

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID
groupId	path	True	string uuid	작업 영역 ID

요청 본문

Name	필수	형식	Description
datasetUserAccessRight	True	DatasetUserAccessRightEntry	필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
identifier	True	string	보안 주체 형식 User의 경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType	True	PrincipalType	보안 주체 유형

응답

Name	형식	Description
200 OK		정상

예제

Example

Example for granting ReadExplore right to a security group

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:

200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

정의

Name	Description
DatasetUserAccessRightEntry	필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
PostDatasetUserAccess	데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
PrincipalType	보안 주체 유형

DatasetUserAccessRightEntry

필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.

Name	형식	Description
Read	string	데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore	string	데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare	string	데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여

PostDatasetUserAccess

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
identifier	string	보안 주체 형식 User의 경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType	PrincipalType	보안 주체 유형

PrincipalType

보안 주체 유형

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