Datasets - Put Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

지정된 사용자의 기존 데이터 세트 권한을 지정된 사용 권한으로 업데이트.

데이터 세트에 대한 사용자 권한이 최근에 업데이트된 경우 API 호출을 통해 새 권한을 즉시 사용할 수 없을 수 있습니다. 사용자 권한을 새로 고치려면 사용자 권한 새로 고침 API 호출을 사용합니다. 이 API 호출을 사용하여 지정된 사용자의 모든 데이터 세트 권한을 제거할 수 있습니다. datasetUserAccessRight: None

필수 범위

Dataset.ReadWrite.All

사용 권한

이 API 호출에 대한 사용 권한은 데이터 세트 권한에 나열됩니다.

제한 사항

• 서비스 주체(앱 principalType)에 대한 권한 업데이트는 지원되지 않습니다.
• 호출자에게 데이터 세트에 대한 ReadWriteReshare 권한이 있어야 합니다. 즉, 다시 공유 권한이 있는 폴더 관리자, 멤버 및 기여자 또는 데이터 세트 소유자입니다.
• 이 API는 쓰기 권한을 추가하거나 제거하는 데 사용할 수 없습니다.
• 이 API는 폴더 수준 상속된 권한을 제거하는 데 사용할 수 없습니다. 폴더 관리자 및 멤버의 경우 폴더의 데이터 세트에 대한 ReadWriteReshareExplore 권한이 상속됩니다. 폴더 참가자의 경우 폴더의 데이터 세트에 대한 ReadWriteExplore 권한이 상속됩니다. 폴더 뷰어의 경우 폴더의 데이터 세트에 대한 읽기 권한이 상속됩니다.
  
  

PUT https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID

요청 본문

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

응답

Name	형식	Description
200 OK		정상

예제

Example

Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

Example for updating security group dataset permissions to ReadExplore

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/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
DatasetUserAccess	데이터 세트에 대한 Power BI 보안 주체 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
PrincipalType	보안 주체 유형

DatasetUserAccess

데이터 세트에 대한 Power BI 보안 주체 액세스 권한 항목

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

DatasetUserAccessRight

사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 세트의 콘텐츠에 대한 사용 권한을 제거합니다.
Read	string	데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore	string	데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare	string	데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadWrite	string	데이터 세트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshare	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore	string	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

PrincipalType

보안 주체 유형

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