Admin - Pipelines UpdateUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

지정된 배포 파이프라인에 사용자 권한을 부여합니다.

사용 권한

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

필수 범위

Tenant.ReadWrite.All

제한 사항

시간당 최대 200개 요청.

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
pipelineId	path	True	string uuid	배포 파이프라인 ID

요청 본문

Name	필수	형식	Description
identifier	True	string	보안 주체 유형의 User경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType	True	PrincipalType	보안 주체 유형
accessRight		PipelineUserAccessRight	필수 요소. 배포 파이프라인에 대해 사용자에게 부여할 수 있는 액세스 권한입니다.

응답

Name	형식	Description
200 OK		정상

예제

Add a group to a deployment pipeline example

Add a service principal to a deployment pipeline example

Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Sample Response

Status code:

200

Add a service principal to a deployment pipeline example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

Add a user to a deployment pipeline example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

Request Body

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Sample Response

Status code:

200

정의

Name	Description
PipelineUser	배포 파이프라인에 대한 Power BI 사용자 액세스 권한 항목
PipelineUserAccessRight	필수 요소. 배포 파이프라인에 대해 사용자에게 부여할 수 있는 액세스 권한입니다.
PrincipalType	보안 주체 유형

PipelineUser

배포 파이프라인에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
accessRight	PipelineUserAccessRight	필수 요소. 배포 파이프라인에 대해 사용자에게 부여할 수 있는 액세스 권한입니다.
identifier	string	보안 주체 유형의 User경우 UPN을 제공합니다. 그렇지 않으면 보안 주체의 개체 ID 를 제공합니다.
principalType	PrincipalType	보안 주체 유형

PipelineUserAccessRight

필수 요소. 배포 파이프라인에 대해 사용자에게 부여할 수 있는 액세스 권한입니다.

Name	형식	Description
Admin	string	배포 파이프라인에 대한 관리자 권한 부여

PrincipalType

보안 주체 유형

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