Datasets - Put Dataset User In Group

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

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

필수 범위

Dataset.ReadWrite.All

사용 권한

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

제한 사항

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

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

URI 매개 변수

요청 본문

응답

예제

Example

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

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

Example for updating security group dataset permissions to ReadExplore

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

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

정의

DatasetUserAccess

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

DatasetUserAccessRight

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

PrincipalType

보안 주체 유형