Items - List Item Access Details

服務:: Admin

API 版本:: v1

傳回使用者清單（包括群組和服務主體），並列出其工作區角色。

Note

此 API 是預覽版的一部分，僅供評估和開發之用。它可能會根據意見反應而變更，不建議用於生產環境。

Permissions

呼叫端必須是網狀架構系統管理員，或使用服務主體進行驗證。

必要的委派範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

Limitations

每小時最多 200 個要求。

Microsoft Entra 支援的身分識別

此 API 支援本節中列出的Microsoft 身分識別。

Identity	Support
User	Yes
服務主體和受控識別	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 參數

名稱	位於	必要	類型	Description
itemId	path	True	string (uuid)	項目標識碼。
workspaceId	path	True	string (uuid)	工作區標識碼。
type	query		string	專案的型別。查詢下列類型時，需要此參數：報告 Dashboard SemanticModel App Dataflow

名稱

位於

必要

類型

Description

itemId

path

True

string (uuid)

項目標識碼。

workspaceId

path

True

string (uuid)

工作區標識碼。

type

query

string

專案的型別。查詢下列類型時，需要此參數：

報告
Dashboard
SemanticModel
App
Dataflow

回應

名稱	類型	Description
200 OK	ItemAccessDetailsResponse	作業成功。
Other Status Codes	ErrorResponse	常見的錯誤碼： ItemNotFound - 項目識別碼不存在。 InvalidItemType - 項目類型無效。

名稱

類型

Description

200 OK

ItemAccessDetailsResponse

作業成功。

Other Status Codes

ErrorResponse

常見的錯誤碼：

ItemNotFound - 項目識別碼不存在。
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": []
      }
    }
  ]
}

定義

名稱	Description
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
GroupDetails	群組特定詳細數據。當主體類型 `Group`時適用。
GroupType	群組的類型。可能會隨著時間新增其他群組類型。
ItemAccessDetail	項目許可權詳細數據，例如讀取和重新共用。
ItemAccessDetails	使用者存取專案的詳細數據。
ItemAccessDetailsResponse	具有指定實體存取權的用戶清單。
ItemPermissions	項目許可權。可能會隨著時間新增其他項目許可權。
ItemType	專案的型別。可能會隨著時間新增其他項目類型。
Principal	代表身分識別或Microsoft Entra 群組。
PrincipalType	主體的類型。可能會隨著時間新增其他主體類型。
ServicePrincipalDetails	服務主體特定詳細數據。當主體類型 `ServicePrincipal`時適用。
ServicePrincipalProfileDetails	服務主體配置檔詳細數據。當主體類型 `ServicePrincipalProfile`時適用。
UserDetails	用戶主體特定詳細數據。當主體類型 `User`時適用。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

GroupDetails

Object

群組特定詳細數據。當主體類型 Group時適用。

名稱	類型	Description
groupType	GroupType	群組的類型。可能會隨著時間新增其他群組類型。

GroupType

列舉型別

群組的類型。可能會隨著時間新增其他群組類型。

值	Description
Unknown	主體群組類型未知。
SecurityGroup	主體是安全組。
DistributionList	主體是通訊組清單。

ItemAccessDetail

Object

項目許可權詳細數據，例如讀取和 重新共用。

名稱	類型	Description
additionalPermissions	string[]	工作負載許可權，例如 readAll 和 viewOutput。
permissions	ItemPermissions[]	讀取和重新共享等項目許可權。
type	ItemType	實體類型。

ItemAccessDetails

Object

使用者存取專案的詳細數據。

名稱	類型	Description
itemAccessDetails	ItemAccessDetail	使用者的項目許可權。
principal	Principal	可存取實體之使用者的相關信息。

ItemAccessDetailsResponse

Object

具有指定實體存取權的用戶清單。

名稱	類型	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	異常偵測器。
UserDataFunction	使用者資料函數。
GraphModel	GraphModel 的 GraphModel。
GraphQuerySet	圖形 QuerySet。
SnowflakeDatabase	一個 Snowflake 資料庫，用來儲存由 Snowflake 帳號建立的 Iceberg 表格。
OperationsAgent	一個行動特工。
CosmosDBDatabase	一個 Cosmos 資料庫。
Ontology	一個本體論。
EventSchemaSet	一個事件結構集。

Principal

Object

代表身分識別或Microsoft Entra 群組。

名稱	類型	Description
displayName	string	主體的顯示名稱。
groupDetails	GroupDetails	群組特定詳細數據。當主體類型 `Group`時適用。
id	string (uuid)	主體的標識碼。
servicePrincipalDetails	ServicePrincipalDetails	服務主體特定詳細數據。當主體類型 `ServicePrincipal`時適用。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	服務主體配置檔詳細數據。當主體類型 `ServicePrincipalProfile`時適用。
type	PrincipalType	主體的類型。可能會隨著時間新增其他主體類型。
userDetails	UserDetails	用戶主體特定詳細數據。當主體類型 `User`時適用。

PrincipalType

列舉型別

主體的類型。可能會隨著時間新增其他主體類型。

值	Description
User	主體是 entra 用戶主體Microsoft。
ServicePrincipal	主體是Microsoft Entra 服務主體。
Group	主體是安全組。
ServicePrincipalProfile	主體是服務主體配置檔。
EntireTenant	主體代表所有租用戶使用者。

ServicePrincipalDetails

Object

服務主體特定詳細數據。當主體類型 ServicePrincipal時適用。

名稱	類型	Description
aadAppId	string (uuid)	服務主體的 Microsoft Entra AppId。

ServicePrincipalProfileDetails

Object

服務主體配置檔詳細數據。當主體類型 ServicePrincipalProfile時適用。

名稱	類型	Description
parentPrincipal	Principal	服務主體配置檔的父主體。

UserDetails

Object

用戶主體特定詳細數據。當主體類型 User時適用。

名稱	類型	Description
userPrincipalName	string	用戶主體名稱。

共用方式為

Items - List Item Access Details

Permissions

必要的委派範圍

Limitations

Microsoft Entra 支援的身分識別

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