Datasets - Get Dataset Users

참조

Service:: Power BI REST APIs

API Version:: v1.0

지정된 데이터 세트에 액세스할 수 있는 보안 주체 목록을 반환합니다.

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

사용 권한

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

필수 범위

Dataset.Read.All 또는 Dataset.ReadWrite.All

제한 사항

호출자에게 데이터 세트에 대한 ReadWriteReshare 권한이 있어야 합니다. 즉, 폴더 관리자, 구성원 및 재공유 권한이 있는 기여자 또는 데이터 세트 소유자입니다.

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

URI 매개 변수

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

응답

Name	형식	Description
200 OK	DatasetUsersAccess	정상

예제

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

정의

Name	Description
DatasetUserAccess	데이터 세트에 대한 Power BI 보안 주체 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
DatasetUsersAccess	데이터 세트에 액세스할 수 있는 Power BI 보안 주체 목록의 OData 응답 래퍼
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	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

DatasetUsersAccess

데이터 세트에 액세스할 수 있는 Power BI 보안 주체 목록의 OData 응답 래퍼

Name	형식	Description
odata.context	string
value	DatasetUserAccess[]	데이터 세트에 액세스할 수 있는 사용자 목록

PrincipalType

보안 주체 유형

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

Share via