다음을 통해 공유

Gateways - Add Datasource User

서비스:
Power BI REST APIs
API 버전:
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

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
요청 본문
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

샘플 응답

상태 코드:
200

Example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
요청 본문
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

샘플 응답

상태 코드:
200

정의

Name Description
DatasourceUser

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

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

보안 주체 형식
ServicePrincipalProfile

Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.

DatasourceUser

Object

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

Name 형식 Description
datasourceAccessRight

DatasourceUserAccessRight

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

string

보안 주체의 표시 이름
emailAddress

string

사용자의 전자 메일 주소
identifier

string

보안 주체의 개체 ID
principalType

PrincipalType

보안 주체 형식
profile

ServicePrincipalProfile

Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.

DatasourceUserAccessRight

열거형

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

값 Description
None

데이터 원본에 액세스할 수 있는 권한이 없습니다. 사용자 권한을 업데이트할 때만 적용됩니다.
Read

사용자가 소유한 데이터 세트는 데이터 원본에 대한 읽기 액세스 권한이 있습니다.
ReadOverrideEffectiveIdentity

사용자는 Power BI Embedded의 유효 ID를 재정의할 수 있습니다. 온-프레미스 Analysis Services 데이터 원본에만 적용됩니다.

PrincipalType

열거형

보안 주체 형식

값 Description
None

보안 주체 형식이 없습니다. 전체 조직 수준 액세스에 사용합니다.
User

사용자 계정 유형
Group

그룹 보안 주체 유형
App

서비스 주체 유형

ServicePrincipalProfile

Object

Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.

Name 형식 Description
displayName

string

서비스 주체 프로필 이름
id

string (uuid)

서비스 주체 프로필 ID