Items - Move Item

服務:: Core

API 版本:: v1

將指定的項目移至相同工作區內的資料夾。子項目會與其父項目一起移動。您無法移動沒有父項目的子項目。

備註

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

權限

呼叫者必須在工作區上具有 參與者 或更高角色。

必要的委派範圍

Workspace.ReadWrite.All

Microsoft Entra 支援的身份識別

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

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

介面

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/move

URI 參數

名稱	位於	必要	類型	Description
itemId	path	True	string (uuid)	項目標識碼。
workspaceId	path	True	string (uuid)	工作區識別碼。

要求本文

名稱	類型	Description
targetFolderId	string (uuid)	目的地資料夾識別碼。如果未提供，則工作區會用作目的地資料夾。

回應

名稱	類型	Description
200 OK	MovedItems	請求已成功完成。
Other Status Codes	ErrorResponse	常見錯誤碼： ItemNotFound - 找不到要求的專案。 FolderNotFound - 找不到要求的資料夾。 CannotMoveChildOnly - 子專案無法在沒有其父專案的情況下移動。

名稱

類型

Description

200 OK

MovedItems

請求已成功完成。

Other Status Codes

ErrorResponse

常見錯誤碼：

ItemNotFound - 找不到要求的專案。
FolderNotFound - 找不到要求的資料夾。
CannotMoveChildOnly - 子專案無法在沒有其父專案的情況下移動。

範例

Move an item into folder example

Move an item with the workspace as the destination example

Move an item into folder example

範例要求

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items/cccccccc-2222-3333-4444-dddddddddddd/move

{
  "targetFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "type": "Lakehouse",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "type": "SQLEndpoint",
      "displayName": "MyLakehouse",
      "description": null,
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    }
  ]
}

Move an item with the workspace as the destination example

範例要求

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items/cccccccc-2222-3333-4444-dddddddddddd/move

{}

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "type": "Lakehouse",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "type": "SQLEndpoint",
      "displayName": "MyLakehouse",
      "description": null,
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

定義

名稱	Description
ErrorRelatedResource	錯誤相關資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細資料。
Item	項目物件。
ItemTag	表示在專案上套用的標記。
ItemType	專案的型別。可能會隨著時間新增其他項目類型。
MovedItems
MoveItemRequest	移動項目要求。

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	項目顯示名稱。
folderId	string (uuid)	資料夾識別碼。
id	string (uuid)	項目標識碼。
tags	ItemTag[]	已套用標籤的清單。
type	ItemType	項目類型。
workspaceId	string (uuid)	工作區識別碼。

ItemTag

Object

表示在專案上套用的標記。

名稱	類型	Description
displayName	string	標籤的名稱。
id	string (uuid)	標記標識碼。

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	一個事件結構集。

MovedItems

Object

名稱	類型	Description
value	Item[]	項目清單。

MoveItemRequest

Object

移動項目要求。

名稱	類型	Description
targetFolderId	string (uuid)	目的地資料夾識別碼。如果未提供，則工作區會用作目的地資料夾。

共用方式為

Items - Move Item

權限

必要的委派範圍

Microsoft Entra 支援的身份識別

介面

URI 參數

要求本文

回應

範例

Move an item into folder example

範例要求

範例回覆

Move an item with the workspace as the destination example

範例要求

範例回覆

定義

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Item

ItemTag

ItemType

MovedItems

MoveItemRequest