共用方式為

Items - List Items

  • 參考
服務:
Core
API 版本:
v1

從指定的工作區傳回項目清單。
此 API 支援 分頁。

權限

呼叫端必須具有 查看器 或更高的工作區角色。

必要的委派範圍

Workspace.Read.All 或 Workspace.ReadWrite.All

Microsoft Entra 支援的身分識別

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

身份 支援
使用者 是的
服務主體 和 受控識別 是的

介面

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
含選擇性參數: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items?type={type}&continuationToken={continuationToken}

URI 參數

名稱 位於 必要 類型 Description
workspaceId
 path True

string

uuid

工作區標識碼。
continuationToken
 query

string

用來擷取下一頁結果的令牌。
type
 query

string

專案的型別。

回應

名稱 類型 Description
200 OK

Items

要求成功完成。
Other Status Codes

ErrorResponse

常見的錯誤碼：

  • InvalidItemType - 無效的項目類型。

範例

List item in workspace with continuation example
List items in workspace by type query parameter example
List items in workspace example

List item in workspace with continuation example

範例要求

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?continuationToken=LDEsMTAwMDAwLDA%3D"
}

List items in workspace by type query parameter example

範例要求

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?type=Lakehouse

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse Name 1",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

List items in workspace example

範例要求

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

範例回覆

狀態碼:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

定義

名稱 Description
ErrorRelatedResource

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

錯誤回應。
ErrorResponseDetails

錯誤回應詳細數據。
Item

項目物件。
Items
ItemType

專案的型別。 可能會隨著時間新增其他項目類型。

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

錯誤相關的資源詳細數據。

Item

Object

項目物件。

名稱 類型 Description
description

string

專案描述。
displayName

string

項目顯示名稱。
id

string

uuid

項目標識碼。
type

ItemType

項目類型。
workspaceId

string

uuid

工作區標識碼。

Items

Object
名稱 類型 Description
continuationToken

string

下一個結果集批次的令牌。 如果沒有其他記錄，則會從回應中移除。
continuationUri

string

下一個結果集批次的 URI。 如果沒有其他記錄，則會從回應中移除。
value

Item[]

項目清單。

ItemType

Enumeration

專案的型別。 可能會隨著時間新增其他項目類型。

值 Description
Dashboard

PowerBI 儀錶板。
DataPipeline

數據管線。
Datamart

PowerBI datamart。
Environment

環境。
Eventhouse

事件屋。
Eventstream

eventstream。
GraphQLApi

GraphQL 專案的 API。
KQLDashboard

KQL 儀錶板。
KQLDatabase

KQL 資料庫。
KQLQueryset

KQL 查詢集。
Lakehouse

湖屋
MLExperiment

機器學習實驗。
MLModel

機器學習模型。
MirroredDatabase

鏡像資料庫。
MirroredWarehouse

鏡像倉儲。
MountedDataFactory

MountedDataFactory。
Notebook

筆記本。
PaginatedReport

PowerBI 編頁報表。
Reflex

反射。
Report

PowerBI 報表。
SQLDatabase

SQLDatabase。
SQLEndpoint

SQL 端點。
SemanticModel

PowerBI 語意模型。
SparkJobDefinition

Spark 作業定義。
Warehouse

倉儲。