다음을 통해 공유

Datasets - Post Dataset User

  • 참조
서비스:
Power BI REST APIs
API 버전:
v1.0

지정된 데이터 세트에 지정된 사용자의 권한을 부여합니다.

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

필수 범위

Dataset.ReadWrite.All

제한 사항

  • 서비스 주체에 사용 권한 추가(앱 principalType)는 지원되지 않습니다.
  • 호출자에게 데이터 세트에 대한 ReadReshare 권한이 있어야 합니다.
  • 이 API 호출은 데이터 세트에 대한 데이터 세트 쓰기 권한을 부여하는 데 사용할 수 없습니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
 path True

string

데이터 세트 ID

요청 본문

Name 필수 형식 Description
datasetUserAccessRight True

DatasetUserAccessRightEntry

필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
identifier True

string

보안 주체 형식 User의 경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType True

PrincipalType

보안 주체 유형

응답

Name 형식 Description
200 OK

정상

예제

Example
Example for granting ReadExplore right to a security group

Example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
요청 본문
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

샘플 응답

상태 코드:
200

Example for granting ReadExplore right to a security group

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
요청 본문
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

샘플 응답

상태 코드:
200

정의

Name Description
DatasetUserAccessRightEntry

필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
PostDatasetUserAccess

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
PrincipalType

보안 주체 유형

DatasetUserAccessRightEntry

Enumeration

필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.

값 Description
Read

데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore

데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare

데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore

데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여

PostDatasetUserAccess

Object

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목

Name 형식 Description
datasetUserAccessRight

DatasetUserAccessRightEntry

필수 요소. 데이터 세트에 대해 사용자에게 부여할 액세스 권한입니다.
identifier

string

보안 주체 형식 User의 경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType

PrincipalType

보안 주체 유형

PrincipalType

Enumeration

보안 주체 유형

값 Description
App

서비스 주체 유형
Group

그룹 보안 주체 유형
None

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

사용자 보안 주체 유형