Items - Get Upstream Relations (beta)

服務:: Core

API 版本:: v1

為某個物品取得上游關係。

Note

此 API 屬於 Beta 版本，僅供評估與開發用途。它可能會根據意見反應而變更，不建議用於生產環境。 呼叫此 API 時，呼叫端必須指定 true 為查詢參數 beta的值。

回傳指定項目上游的所有項目，包括關係邊和參考工作區。

權限

呼叫端必須具有專案的讀取許可權。

必要的委派範圍

Item.Read.All 或 Item.ReadWrite.All

Microsoft Entra 支援的身份識別

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

身分識別	Support
User	Yes
服務主體和受控識別	Yes

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/relations/upstream?beta={beta}

URI 參數

名稱	位於	必要	類型	Description
itemId	path	True	string (uuid)	項目標識碼。
workspaceId	path	True	string (uuid)	工作區識別碼。
beta	query	True	boolean	必須設定這個必要的參數才能 `true` 存取目前處於測試階段的 API。

回應

名稱類型 Description

200 OK

名稱	類型	Description
200 OK	RelationsResponse	要求成功完成。
429 Too Many Requests	ErrorResponse	服務費率上限被超標。伺服器會回傳一個 `Retry-After` 標頭，以秒數表示客戶端在發送額外請求前必須等待多久。標題 Retry-After: integer
Other Status Codes	ErrorResponse	常見的錯誤碼： ItemNotFound - 找不到要求的專案。 InsufficientPrivileges - 呼叫端沒有足夠的許可權可存取專案。

RelationsResponse

要求成功完成。

429 Too Many Requests

ErrorResponse

服務費率上限被超標。伺服器會回傳一個 Retry-After 標頭，以秒數表示客戶端在發送額外請求前必須等待多久。

標題

Retry-After: integer

Other Status Codes

ErrorResponse

常見的錯誤碼：

ItemNotFound - 找不到要求的專案。
InsufficientPrivileges - 呼叫端沒有足夠的許可權可存取專案。

範例

Get upstream relations example

範例要求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/3546052c-ae64-4526-b1a8-52af7761426f/relations/upstream?beta=True

範例回覆

狀態碼:: 200

{
  "items": [
    {
      "id": "9b218778-e7a5-4d73-8187-f10824047715",
      "type": "Lakehouse",
      "displayName": "Enterprise Sales Lakehouse",
      "workspaceId": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41"
    }
  ],
  "relations": [
    {
      "itemId": "3546052c-ae64-4526-b1a8-52af7761426f",
      "dependentOnItemId": "9b218778-e7a5-4d73-8187-f10824047715",
      "relationType": "PushData"
    }
  ],
  "workspaces": [
    {
      "id": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41",
      "displayName": "Data Engineering Workspace"
    }
  ]
}

定義

名稱	Description
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應的細節。
ItemType	物品的種類。可能會隨著時間新增其他項目類型。
RelationsEdge	兩個項目之間的關係邊。
RelationsRelatedItem	與指定項目相關的項目。這是完整項目物件的子集，僅包含關係 API 回傳的屬性。
RelationsResponse	一個包含相關項目、關係邊緣及參考工作空間的回應。
RelationsWorkspace	關係回應中提到的工作空間。
RelationType	兩個項目之間的關係類型。隨著時間推移，可能會新增更多關係類型。

ErrorRelatedResource

Object

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

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

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
isRetriable	boolean	若屬實，請求可重新嘗試。如果有延遲，請使用 `Retry-After` 回應標頭來判斷延遲。
message	string	以人類可讀格式呈現的錯誤訊息。
moreDetails	ErrorResponseDetails[]	其他錯誤詳情的清單。
relatedResource	ErrorRelatedResource	與錯誤相關的資源詳情。
requestId	string (uuid)	與錯誤相關聯的要求識別碼。

ErrorResponseDetails

Object

錯誤回應的細節。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	以人類可讀格式呈現的錯誤訊息。
relatedResource	ErrorRelatedResource	與錯誤相關的資源詳情。

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	事件流。
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	一個事件結構集。
DataAgent	一個資料代理人。
MirroredCatalog	鏡像目錄。
AppBackend	一個 AppBackend。
OrgApp	一個組織應用程式。
OrgAppAudience	一個組織應用程式的受眾。
DataBuildToolJob	一個 DataBuildToolJob。
AzureDatabricksStorage	A OneLake backed storage item for Azure Databricks.
Plan	一個計畫。

RelationsEdge

Object

兩個項目之間的關係邊。

名稱	類型	Description
dependentOnItemId	string (uuid)	來源項目所依賴的項目識別碼。
itemId	string (uuid)	來源項目識別碼。
relationType	RelationType	兩個項目之間的關係類型。隨著時間推移，可能會新增更多關係類型。

RelationsRelatedItem

Object

與指定項目相關的項目。這是完整項目物件的子集，僅包含關係 API 回傳的屬性。

名稱	類型	Description
displayName	string	項目顯示名稱。
id	string (uuid)	項目標識碼。
type	ItemType	項目類型。
workspaceId	string (uuid)	包含該項目的工作區 ID。用這個 ID 在清單中找到工作區 `workspaces` 。

RelationsResponse

Object

一個包含相關項目、關係邊緣及參考工作空間的回應。

名稱	類型	Description
items	RelationsRelatedItem[]	相關物品清單。
relations	RelationsEdge[]	項目間的關係邊列表。
workspaces	RelationsWorkspace[]	一份由相關項目參考的工作區清單。

RelationsWorkspace

Object

關係回應中提到的工作空間。

名稱	類型	Description
displayName	string	工作區顯示名稱。
id	string (uuid)	工作區標識碼。

RelationType

列舉型別

兩個項目之間的關係類型。隨著時間推移，可能會新增更多關係類型。

值	Description
CascadeDelete	CascadeDelete 關係表示該項目是 dependentOnItemId 的父項目，刪除該項目會導致受依賴項目也被刪除。
WeakAssociation	弱關聯表示對 dependentOnItemID 所識別的項目存在軟性依賴。如果被依賴項目被刪除，該關係就會被移除。
Datasource	資料來源關係表示對共同資料來源所識別的項目存在軟性依賴。如果被依賴項目被刪除，該關係就會被移除。
PushData	PushData 關係表示依賴項目會寫入/推送資料到依賴項目（由 dependentOnItemID 識別的項目）。如果被依賴項目被刪除，該關係就會被移除。
Orchestration	編排關係表示項目執行依賴項目（由 dependentOnItemID 識別的項目）的管理或編排程序。如果被依賴項目被刪除，該關係就會被移除。
Shortcut	捷徑關係表示某項目有捷徑或連結，指向由 dependentOnItemID 識別的項目中的資料或資料區域。如果被依賴項目被刪除，該關係就會被移除。
HiddenInWorkspace	HiddenInWorkspace 表示擁有此關係的項目將被隱藏在工作區中。