Share via

Admin - Groups DeleteUserAsAdmin

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

지정된 작업 영역에서 사용자 권한을 제거합니다.

이 API 호출은 사용자, 보안 그룹, M365 그룹 및 서비스 주체 제거를 지원합니다. 삭제할 서비스 주체의 경우 사용자, 그룹 개체 ID 및 앱 개체 ID에 전자 메일 주소 또는 UPN을 사용하세요.

사용 권한

사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있어야 합니다.

필수 범위

Tenant.ReadWrite.All

제한 사항

시간당 최대 200개 요청. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
With optional parameters: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

URI 매개 변수

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

string

uuid

작업 영역 ID입니다.
user
 path True

string

삭제할 서비스 주체의 그룹 또는 앱 개체 ID의 사용자 또는 그룹 개체 ID의 UPN(사용자 계정 이름)입니다.
isGroup
 query

boolean

지정된 사용자가 그룹인지 여부입니다. 삭제할 사용자가 그룹인 경우 이 매개 변수가 필요합니다.
profileId
 query

string

uuid

삭제할 서비스 주체 프로필 ID입니다.

응답

Name 형식 Description
200 OK

정상

예제

Delete group example
Delete guest user example
Delete service principal example
Delete user example

Delete group example

Sample Request

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23?isGroup=True

Sample Response

Status code:
200

Delete guest user example

Sample Request

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/john_contoso.com%23EXT%23@test.com

Sample Response

Status code:
200

Delete service principal example

Sample Request

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23

Sample Response

Status code:
200

Delete user example

Sample Request

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d69/users/john@contoso.com

Sample Response

Status code:
200