Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

지정된 사용자가 액세스할 수 있는 Power BI 항목(예: 보고서 또는 대시보드) 목록을 반환합니다.

사용 권한

• 사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
• 위임된 권한이 지원됩니다.

필수 범위

Tenant.Read.All 또는 Tenant.ReadWrite.All

제한 사항

시간당 최대 200개의 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
userId	path	True	string	사용자의 그래프 ID 또는 UPN(사용자 계정 이름)
artifactTypes	query		string	아티팩트 형식의 쉼표로 구분된 목록입니다.
continuationToken	query		string	결과 집합의 다음 청크를 가져오는 데 필요한 토큰

응답

Name	형식	Description
200 OK	ArtifactAccessResponse	정상

예제

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

정의

Name	Description
ArtifactAccessEntry	Power BI 항목에 대한 사용자 액세스 항목
ArtifactAccessResponse	사용자가 액세스할 수 있는 Power BI 항목 목록(예: 보고서 또는 대시보드)에 대한 OData 응답 래퍼
ArtifactType	아티팩트 형식
PrincipalType	보안 주체 유형
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
User	Power BI 사용자

ArtifactAccessEntry

Power BI 항목에 대한 사용자 액세스 항목

Name	형식	Description
accessRight	string	사용자가 Power BI 항목에 대해 가지고 있는 액세스 권한
artifactId	string	Power BI 항목 ID
artifactType	ArtifactType	Power BI 항목의 유형
displayName	string	Power BI 항목의 표시 이름
shareType	string	Power BI 항목에 대한 액세스 권한을 부여하는 방법의 유형입니다. 널리 공유된 아티팩트 API에만 사용할 수 있습니다.
sharer	User	Power BI 항목을 공유한 사용자입니다. 널리 공유된 아티팩트 API에만 사용할 수 있습니다.

ArtifactAccessResponse

사용자가 액세스할 수 있는 Power BI 항목 목록(예: 보고서 또는 대시보드)에 대한 OData 응답 래퍼

Name	형식	Description
artifactAccessEntities	ArtifactAccessEntry[]	사용자가 액세스할 수 있는 Power BI 항목 목록
continuationToken	string	결과 집합의 다음 청크에 대한 토큰
continuationUri	string	결과 집합에서 다음 청크의 URI
odata.context	string

ArtifactType

아티팩트 형식

Name	형식	Description
App	string	Power BI 앱
Capacity	string	Capacity 개체
Dashboard	string	Power BI 대시보드
Dataflow	string	Power BI 데이터 흐름
Dataset	string	Power BI 데이터 세트
Group	string	V1 공유 작업 영역 개체
PaginatedReport	string	Power BI 페이지를 매긴 보고서
PersonalGroup	string	내 작업 영역 개체
Report	string	Power BI 보고서
Workspace	string	공유 작업 영역 개체

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

User

Power BI 사용자

Name	형식	Description
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
userType	string	사용자의 유형입니다.