Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

v1.0

지정된 사용자에 대해 지정된 데이터 원본을 사용하는 데 필요한 권한을 부여하거나 업데이트합니다.

사용 권한

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

필수 범위

Dataset.ReadWrite.All

제한 사항

VNet(가상 네트워크) 게이트웨이는 지원되지 않습니다. API를 통해 그룹을 추가하는 것은 지원되지 않습니다.

POST 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
datasourceAccessRight	True	DatasourceUserAccessRight	사용자가 데이터 원본에 대해 가지고 있는 액세스 권한(권한 수준)
displayName		string	보안 주체의 표시 이름
emailAddress		string	사용자의 이메일 주소입니다.
identifier		string	보안 주체의 개체 ID
principalType		PrincipalType	보안 주체 유형
profile		ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.

응답

Name	형식	Description
200 OK		정상

예제

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Sample Request

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

Request Body

{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Sample Response

Status code:

200

Example

Sample Request

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

Request Body

{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Sample Response

Status code:

200

정의

Name	Description
DatasourceUser	데이터 원본에 액세스할 수 있는 Power BI 사용자
DatasourceUserAccessRight	사용자가 데이터 원본에 대해 가지고 있는 액세스 권한(권한 수준)
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 데이터 원본에만 적용됩니다.

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