Freigeben über

Items - Move Item

Dienst:
Core
API-Version:
v1

Verschieben Sie das angegebene Element in einen Ordner innerhalb desselben Arbeitsbereichs. Untergeordnete Elemente werden mit dem übergeordneten Element verschoben. Sie können ein untergeordnetes Element nicht ohne das übergeordnete Element verschieben.

Hinweis

Diese API ist Teil einer Preview-Version und wird nur für Evaluierungs- und Entwicklungszwecke bereitgestellt. Sie kann sich basierend auf Feedback ändern und wird nicht für den Produktionseinsatz empfohlen.

Erlaubnisse

Der Anrufer muss über einen Mitwirkenden oder eine höhere Rolle im Arbeitsbereich verfügen.

Erforderliche delegierte Bereiche

Arbeitsbereich.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Support
Benutzer Yes
Service Principal und Verwaltete Identitäten Yes

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
itemId
 path True

string (uuid)

Die Element-ID.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Typ Beschreibung
targetFolderId

string (uuid)

Die Zielordner-ID. Wenn nicht angegeben, wird der Arbeitsbereich als Zielordner verwendet.

Antworten

Name Typ Beschreibung
200 OK

MovedItems

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • ItemNotFound – Das angeforderte Element wurde nicht gefunden.

  • FolderNotFound – Der angeforderte Ordner konnte nicht gefunden werden.

  • CannotMoveChildOnly - Untergeordnetes Element kann nicht ohne das übergeordnete Element verschoben werden.

Beispiele

Move an item into folder example
Move an item with the workspace as the destination example

Move an item into folder example

Beispielanforderung

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"
}

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

{}

Beispiel für eine Antwort

Statuscode:
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"
    }
  ]
}

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
Item

Ein Elementobjekt.
ItemTag

Stellt ein Tag dar, das auf ein Element angewendet wird.
ItemType

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
MovedItems
MoveItemRequest

Elementanforderung verschieben.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

Item

Objekt

Ein Elementobjekt.

Name Typ Beschreibung
description

string

Die Elementbeschreibung.
displayName

string

Der Anzeigename des Elements.
folderId

string (uuid)

Die Ordner-ID.
id

string (uuid)

Die Element-ID.
tags

ItemTag[]

Liste der angewendeten Tags.
type

ItemType

Der Elementtyp.
workspaceId

string (uuid)

Die Arbeitsbereichs-ID.

ItemTag

Objekt

Stellt ein Tag dar, das auf ein Element angewendet wird.

Name Typ Beschreibung
displayName

string

Der Name des Tags.
id

string (uuid)

Die Tag-ID.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Dashboard

PowerBI-Dashboard.
Report

PowerBI-Bericht.
SemanticModel

PowerBI-Semantikmodell.
PaginatedReport

PowerBI-Paginated-Bericht.
Datamart

PowerBI datamart.
Lakehouse

Ein Seehaus.
Eventhouse

Ein Eventhouse.
Environment

Eine Umgebung.
KQLDatabase

Eine KQL-Datenbank.
KQLQueryset

Ein KQL-Abfrageset.
KQLDashboard

Ein KQL-Dashboard.
DataPipeline

Eine Datenpipeline.
Notebook

Ein Notizbuch.
SparkJobDefinition

Eine Sparkauftragsdefinition.
MLExperiment

Ein Machine Learning-Experiment.
MLModel

Ein Machine Learning-Modell.
Warehouse

Ein Lagerhaus.
Eventstream

Ein Ereignisstream.
SQLEndpoint

Ein SQL-Endpunkt.
MirroredWarehouse

Ein gespiegeltes Lager.
MirroredDatabase

Eine gespiegelte Datenbank.
Reflex

Ein Reflex.
GraphQLApi

Eine API für GraphQL-Element.
MountedDataFactory

Eine MountedDataFactory.
SQLDatabase

Eine SQLDatabase.
CopyJob

Ein Kopierauftrag.
VariableLibrary

Eine VariableLibrary.
Dataflow

Ein Datenfluss.
ApacheAirflowJob

Ein ApacheAirflowJob.
WarehouseSnapshot

Eine Warehouse-Momentaufnahme.
DigitalTwinBuilder

Ein DigitalTwinBuilder.
DigitalTwinBuilderFlow

Ein Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog

Ein gespiegelter Azure Databricks-Katalog.
Map

Eine Karte.
AnomalyDetector

Anomaliedetektor.
UserDataFunction

Eine Benutzerdatenfunktion.
GraphModel

Ein GraphModel.
GraphQuerySet

Ein Graph QuerySet.
SnowflakeDatabase

Eine Snowflake-Datenbank zum Speichern von Iceberg-Tabellen, die aus dem Snowflake-Konto erstellt wurden.
OperationsAgent

Ein OperationsAgent.
CosmosDBDatabase

Eine Cosmos DB-Datenbank.
Ontology

Eine Ontologie.
EventSchemaSet

Ein EventSchemaSet.

MovedItems

Objekt
Name Typ Beschreibung
value

Item[]

Eine Liste von Elementen.

MoveItemRequest

Objekt

Elementanforderung verschieben.

Name Typ Beschreibung
targetFolderId

string (uuid)

Die Zielordner-ID. Wenn nicht angegeben, wird der Arbeitsbereich als Zielordner verwendet.