다음을 통해 공유


Gateways - Add Datasource User

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

사용 권한

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

필수 범위

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
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Sample Response

Example

Sample Request

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"
}

Sample Response

정의

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