Freigeben über

Folders - Move Folder

Dienst:
Core
API-Version:
v1

Verschiebt den angegebenen Ordner innerhalb desselben Arbeitsbereichs.

Note

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.

Permissions

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

Erforderliche delegierte Bereiche

Workspace.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

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

Identity Support
User Yes
Service Principal und Verwaltete Identitäten Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/folders/{folderId}/move

URI-Parameter

Name In Erforderlich Typ Beschreibung
folderId
 path True

string (uuid)

Die Ordner-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

Folder

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • FolderNotFound – Der angeforderte Ordner konnte nicht gefunden werden.

  • FolderDepthOutOfRange – Der übergeordnete Ordner hat die maximale Tiefe erreicht, kann keinen neuen Unterordner erstellen.

  • InfiniteFolderHierarchyLoop - Der Ordner kann nicht in einen seiner Abstiege verschoben werden.

  • FolderDisplayNameAlreadyInUse - Der Anzeigename des Ordners wird bereits verwendet.

Beispiele

Move a folder into another folder example
Move a folder with the workspace as the destination example

Move a folder into another folder example

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/dddddddd-9999-0000-1111-eeeeeeeeeeee/move

{
  "targetFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

Move a folder with the workspace as the destination example

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/dddddddd-9999-0000-1111-eeeeeeeeeeee/move

{}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
Folder

Ein Ordnerobjekt.
MoveFolderRequest

Ordneranforderung 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.

Folder

Objekt

Ein Ordnerobjekt.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Ordners.
id

string (uuid)

Die Ordner-ID.
parentFolderId

string (uuid)

Die id des übergeordneten Ordners. Wenn der übergeordnete Ordner ein Arbeitsbereich ist, wird parentFolderId entweder nicht angegeben oder null.
workspaceId

string (uuid)

Die Arbeitsbereichs-ID.

MoveFolderRequest

Objekt

Ordneranforderung verschieben.

Name Typ Beschreibung
targetFolderId

string (uuid)

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