Items - List Item Access Details

서비스:: Admin

API 버전:: v1

사용자 목록(그룹 및 서비스 주체 포함)을 반환하고 해당 작업 영역 역할을 나열합니다.

Note

이 API는 미리 보기 릴리스의 일부이며 평가 및 개발 목적으로만 제공됩니다. 피드백에 따라 변경 될 수 있으며 프로덕션 사용에는 권장되지 않습니다.

Permissions

호출자는 패브릭 관리자이거나 서비스 주체를 사용하여 인증해야 합니다.

필요한 위임된 범위

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

Limitations

시간당 최대 200개 요청

Microsoft Entra 지원 ID

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

Identity	Support
User	Yes
서비스 주체 및 관리 ID	Yes

Interface

GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users

선택적 매개 변수:

GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users?type={type}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
itemId	path	True	string (uuid)	항목 ID입니다.
workspaceId	path	True	string (uuid)	작업 영역 ID입니다.
type	query		string	항목의 형식입니다. 다음 형식을 쿼리할 때 이 매개 변수가 필요합니다. Report Dashboard SemanticModel App Dataflow

Name

In(다음 안에)

필수

형식

Description

itemId

path

True

string (uuid)

항목 ID입니다.

workspaceId

path

True

string (uuid)

작업 영역 ID입니다.

type

query

string

항목의 형식입니다. 다음 형식을 쿼리할 때 이 매개 변수가 필요합니다.

Report
Dashboard
SemanticModel
App
Dataflow

응답

Name	형식	Description
200 OK	ItemAccessDetailsResponse	작업이 성공했습니다.
Other Status Codes	ErrorResponse	일반적인 오류 코드: ItemNotFound - 항목 ID가 없습니다. InvalidItemType - 항목 유형이 잘못되었습니다.

Name

형식

Description

200 OK

ItemAccessDetailsResponse

작업이 성공했습니다.

Other Status Codes

ErrorResponse

일반적인 오류 코드:

ItemNotFound - 항목 ID가 없습니다.
InvalidItemType - 항목 유형이 잘못되었습니다.

예제

List of users for given item ID and type example

List of users for given item ID example

List of users for given item ID and type example

샘플 요청

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users?type=Report

샘플 응답

상태 코드:: 200

{
  "accessDetails": [
    {
      "principal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Report",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": [
          "ReadAll"
        ]
      }
    }
  ]
}

List of users for given item ID example

샘플 요청

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

샘플 응답

상태 코드:: 200

{
  "accessDetails": [
    {
      "principal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": [
          "ReadAll",
          "viewOutput"
        ]
      }
    },
    {
      "principal": {
        "id": "c7db8e03-c8cb-4d4c-9f64-1dcd327c9d3c",
        "displayName": "Eric Solomon",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare",
          "Explore"
        ],
        "additionalPermissions": [
          "ReadAll"
        ]
      }
    },
    {
      "principal": {
        "id": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
        "displayName": "TestSecurityGroup",
        "type": "Group",
        "groupDetails": {
          "groupType": "SecurityGroup"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": []
      }
    }
  ]
}

정의

Name	Description
ErrorRelatedResource	오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse	오류 응답입니다.
ErrorResponseDetails	오류 응답 세부 정보입니다.
GroupDetails	특정 세부 정보를 그룹화합니다. 보안 주체 형식이 `Group`경우에 적용됩니다.
GroupType	그룹의 형식입니다. 추가 그룹 유형은 시간이 지남에 따라 추가될 수 있습니다.
ItemAccessDetail	읽기 및 다시 공유와 같은 항목 권한 세부 정보입니다.
ItemAccessDetails	항목에 대한 사용자 액세스 세부 정보입니다.
ItemAccessDetailsResponse	지정된 엔터티에 액세스할 수 있는 사용자 목록입니다.
ItemPermissions	항목 권한. 추가 항목 사용 권한은 시간이 지남에 따라 추가될 수 있습니다.
ItemType	항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다.
Principal	ID 또는 Microsoft Entra 그룹을 나타냅니다.
PrincipalType	보안 주체의 형식입니다. 시간이 지남에 따라 추가 보안 주체 형식을 추가할 수 있습니다.
ServicePrincipalDetails	서비스 주체별 세부 정보입니다. 보안 주체 형식이 `ServicePrincipal`경우에 적용됩니다.
ServicePrincipalProfileDetails	서비스 주체 프로필 세부 정보입니다. 보안 주체 형식이 `ServicePrincipalProfile`경우에 적용됩니다.
UserDetails	사용자 보안 주체별 세부 정보입니다. 보안 주체 형식이 `User`경우에 적용됩니다.

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

Name	형식	Description
resourceId	string	오류와 관련된 리소스 ID입니다.
resourceType	string	오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

Name	형식	Description
errorCode	string	오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message	string	사용자가 읽을 수 있는 오류 표현입니다.
moreDetails	ErrorResponseDetails[]	추가 오류 세부 정보 목록입니다.
relatedResource	ErrorRelatedResource	오류 관련 리소스 세부 정보입니다.
requestId	string	오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

Name	형식	Description
errorCode	string	오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message	string	사용자가 읽을 수 있는 오류 표현입니다.
relatedResource	ErrorRelatedResource	오류 관련 리소스 세부 정보입니다.

GroupDetails

Object

특정 세부 정보를 그룹화합니다. 보안 주체 형식이 Group경우에 적용됩니다.

Name	형식	Description
groupType	GroupType	그룹의 형식입니다. 추가 그룹 유형은 시간이 지남에 따라 추가될 수 있습니다.

GroupType

열거형

그룹의 형식입니다. 추가 그룹 유형은 시간이 지남에 따라 추가될 수 있습니다.

값	Description
Unknown	보안 주체 그룹 유형을 알 수 없습니다.
SecurityGroup	보안 주체는 보안 그룹입니다.
DistributionList	보안 주체는 메일 그룹입니다.

ItemAccessDetail

Object

읽기 및 다시 공유와 같은 항목 권한 세부 정보입니다.

Name	형식	Description
additionalPermissions	string[]	readAll 및 viewOutput과 같은 워크로드 권한
permissions	ItemPermissions[]	읽기 및 다시 공유와 같은 항목 권한입니다.
type	ItemType	개체 유형입니다.

ItemAccessDetails

Object

항목에 대한 사용자 액세스 세부 정보입니다.

Name	형식	Description
itemAccessDetails	ItemAccessDetail	사용자에 대한 항목 권한입니다.
principal	Principal	엔터티에 대한 액세스 권한이 있는 사용자에 대한 정보입니다.

ItemAccessDetailsResponse

Object

지정된 엔터티에 액세스할 수 있는 사용자 목록입니다.

Name	형식	Description
accessDetails	ItemAccessDetails[]	엔터티에 액세스할 수 있는 사용자 목록입니다.

ItemPermissions

열거형

항목 권한. 추가 항목 사용 권한은 시간이 지남에 따라 추가될 수 있습니다.

값	Description
Read	사용자는 항목에 대한 메타데이터를 읽을 수 있습니다.
Write	사용자는 항목에 대한 쓰기 작업을 수행할 수 있습니다.
Reshare	사용자는 다른 사용자와 항목을 공유할 수 있습니다.
Explore	사용자는 다른 항목에 항목을 빌드할 수 있습니다.
Execute	사용자는 항목 작업을 실행하고 취소할 수 있습니다.

ItemType

열거형

항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다.

값	Description
Dashboard	PowerBI 대시보드.
Report	PowerBI 보고서입니다.
SemanticModel	PowerBI 의미 체계 모델입니다.
PaginatedReport	PowerBI 페이지를 매긴 보고서입니다.
Datamart	PowerBI datamart.
Lakehouse	레이크 하우스.
Eventhouse	이벤트 하우스.
Environment	환경입니다.
KQLDatabase	KQL 데이터베이스입니다.
KQLQueryset	KQL 쿼리 세트입니다.
KQLDashboard	KQL 대시보드.
DataPipeline	데이터 파이프라인입니다.
Notebook	공책.
SparkJobDefinition	Spark 작업 정의입니다.
MLExperiment	기계 학습 실험입니다.
MLModel	기계 학습 모델입니다.
Warehouse	창고.
Eventstream	eventstream입니다.
SQLEndpoint	SQL 엔드포인트입니다.
MirroredWarehouse	미러된 창고입니다.
MirroredDatabase	미러된 데이터베이스입니다.
Reflex	반사.
GraphQLApi	GraphQL 항목에 대한 API입니다.
MountedDataFactory	MountedDataFactory입니다.
SQLDatabase	SQLDatabase입니다.
CopyJob	복사 작업입니다.
VariableLibrary	VariableLibrary입니다.
Dataflow	데이터 흐름입니다.
ApacheAirflowJob	ApacheAirflowJob입니다.
WarehouseSnapshot	웨어하우스 스냅샷.
DigitalTwinBuilder	DigitalTwinBuilder입니다.
DigitalTwinBuilderFlow	디지털 트윈 빌더 흐름입니다.
MirroredAzureDatabricksCatalog	미러된 Azure Databricks 카탈로그입니다.
Map	지도입니다.
AnomalyDetector	Anomaly Detector입니다.
UserDataFunction	사용자 데이터 함수입니다.
GraphModel	GraphModel입니다.
GraphQuerySet	Graph QuerySet입니다.
SnowflakeDatabase	Snowflake 계정에서 만든 빙산 테이블을 저장하는 Snowflake 데이터베이스입니다.
OperationsAgent	OperationsAgent입니다.
CosmosDBDatabase	Cosmos DB 데이터베이스입니다.
Ontology	온톨로지입니다.
EventSchemaSet	EventSchemaSet입니다.

Principal

Object

ID 또는 Microsoft Entra 그룹을 나타냅니다.

Name	형식	Description
displayName	string	보안 주체의 표시 이름입니다.
groupDetails	GroupDetails	특정 세부 정보를 그룹화합니다. 보안 주체 형식이 `Group`경우에 적용됩니다.
id	string (uuid)	보안 주체의 ID입니다.
servicePrincipalDetails	ServicePrincipalDetails	서비스 주체별 세부 정보입니다. 보안 주체 형식이 `ServicePrincipal`경우에 적용됩니다.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	서비스 주체 프로필 세부 정보입니다. 보안 주체 형식이 `ServicePrincipalProfile`경우에 적용됩니다.
type	PrincipalType	보안 주체의 형식입니다. 시간이 지남에 따라 추가 보안 주체 형식을 추가할 수 있습니다.
userDetails	UserDetails	사용자 보안 주체별 세부 정보입니다. 보안 주체 형식이 `User`경우에 적용됩니다.

PrincipalType

열거형

보안 주체의 형식입니다. 시간이 지남에 따라 추가 보안 주체 형식을 추가할 수 있습니다.

값	Description
User	보안 주체는 Microsoft Entra 사용자 보안 주체입니다.
ServicePrincipal	보안 주체는 Microsoft Entra 서비스 주체입니다.
Group	보안 주체는 보안 그룹입니다.
ServicePrincipalProfile	보안 주체는 서비스 주체 프로필입니다.
EntireTenant	보안 주체는 모든 테넌트 사용자를 나타냅니다.

ServicePrincipalDetails

Object

서비스 주체별 세부 정보입니다. 보안 주체 형식이 ServicePrincipal경우에 적용됩니다.

Name	형식	Description
aadAppId	string (uuid)	서비스 주체의 Microsoft Entra AppId입니다.

ServicePrincipalProfileDetails

Object

서비스 주체 프로필 세부 정보입니다. 보안 주체 형식이 ServicePrincipalProfile경우에 적용됩니다.

Name	형식	Description
parentPrincipal	Principal	서비스 주체 프로필의 부모 보안 주체입니다.

UserDetails

Object

사용자 보안 주체별 세부 정보입니다. 보안 주체 형식이 User경우에 적용됩니다.

Name	형식	Description
userPrincipalName	string	사용자 계정 이름입니다.

다음을 통해 공유

Items - List Item Access Details

Permissions

필요한 위임된 범위

Limitations

Microsoft Entra 지원 ID

Interface

URI 매개 변수

응답

예제

List of users for given item ID and type example

샘플 요청

샘플 응답

List of users for given item ID example

샘플 요청

샘플 응답

정의

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemAccessDetail

ItemAccessDetails

ItemAccessDetailsResponse

ItemPermissions

ItemType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails