Gateways - Get Datasource Users

Service:

Power BI REST APIs

API Version:

v1.0

지정된 데이터 원본에 액세스할 수 있는 사용자 목록을 반환합니다.

사용 권한

사용자에게 게이트웨이 관리자 권한이 있어야 합니다.

필수 범위

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

제한 사항

VNet(가상 네트워크) 게이트웨이는 지원되지 않습니다.

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasourceId	path	True	string uuid	데이터 원본 ID
gatewayId	path	True	string uuid	게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조합니다. 이러한 경우 게이트웨이 ID는 게이트웨이 클러스터 ID와 유사합니다.

응답

Name	형식	Description
200 OK	DatasourceUsers	정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Sample Response

Status code:

200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

정의

Name	Description
DatasourceUser	데이터 원본에 액세스할 수 있는 Power BI 사용자
DatasourceUserAccessRight	사용자가 데이터 원본에 있는 액세스 권한(권한 수준)
DatasourceUsers	데이터 원본에 액세스할 수 있는 Power BI 사용자 목록의 OData 응답 래퍼
PrincipalType	보안 주체 유형
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

DatasourceUser

데이터 원본에 액세스할 수 있는 Power BI 사용자

Name	형식	Description
datasourceAccessRight	DatasourceUserAccessRight	사용자가 데이터 원본에 있는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
identifier	string	보안 주체의 개체 ID
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

DatasourceUserAccessRight

사용자가 데이터 원본에 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 원본에 액세스할 수 있는 권한이 없습니다. 사용자 권한을 업데이트할 때만 적용됩니다.
Read	string	사용자가 소유한 데이터 세트는 데이터 원본에 대한 읽기 권한이 있습니다.
ReadOverrideEffectiveIdentity	string	사용자는 Power BI Embedded 대한 유효 ID를 재정의할 수 있습니다. 온-프레미스 Analysis Services 데이터 원본에만 적용됩니다.

DatasourceUsers

데이터 원본에 액세스할 수 있는 Power BI 사용자 목록의 OData 응답 래퍼

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

PrincipalType

보안 주체 유형

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

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

Name	형식	Description
displayName	string	서비스 주체 프로필 이름
id	string	서비스 주체 프로필 ID