Folders - Move Folder

Servizio:

Core

Versione API:

v1

Sposta la cartella specificata all'interno della stessa area di lavoro.

Note

Questa API fa parte di una versione di anteprima e viene fornita solo a scopo di valutazione e sviluppo. Può cambiare in base al feedback e non è consigliato per l'uso in produzione.

Permissions

Il chiamante deve avere un ruolo di collaboratore o superiore nell'area di lavoro.

Ambiti delegati obbligatori

Workspace.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identity	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interface

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
folderId	path	True	string (uuid)	ID cartella.
workspaceId	path	True	string (uuid)	ID dell'area di lavoro.

Corpo della richiesta

Nome	Tipo	Descrizione
targetFolderId	string (uuid)	ID cartella di destinazione. Se non specificato, l'area di lavoro viene usata come cartella di destinazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Folder	Richiesta completata correttamente.
Other Status Codes	ErrorResponse	Codici di errore comuni: FolderNotFound: impossibile trovare la cartella richiesta. FolderDepthOutOfRange: la cartella padre ha raggiunto la profondità massima, non può creare una nuova sottocartella. InfiniteFolderHierarchyLoop: la cartella non può essere spostata in nessuna delle relative discese. FolderDisplayNameAlreadyInUse - Nome visualizzato cartella già usato.

Esempio

Move a folder into another folder example

Move a folder with the workspace as the destination example

Move a folder into another folder example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

HTTP

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

{}

Risposta di esempio

Codice di stato:

200

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

Definizioni

Nome	Descrizione
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
Folder	Oggetto cartella.
MoveFolderRequest	Spostamento della richiesta di cartella.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

Folder

Object

Oggetto cartella.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato della cartella.
id	string (uuid)	ID cartella.
parentFolderId	string (uuid)	ID cartella padre. Se la cartella padre è un'area di lavoro, parentFolderId non è specificato o null.
workspaceId	string (uuid)	ID dell'area di lavoro.

MoveFolderRequest

Object

Spostamento della richiesta di cartella.

Nome	Tipo	Descrizione
targetFolderId	string (uuid)	ID cartella di destinazione. Se non specificato, l'area di lavoro viene usata come cartella di destinazione.