Folders - Move Folder

Szolgáltatás:

Core

API-verzió:

v1

Megjegyzés

Az API előzetes verzióban érhető el.

Áthelyezi a megadott mappát ugyanazon a munkaterületen belül.

Engedélyek

A hívónak közreműködői vagy magasabb szerepkörűnek kell lennie a munkaterületen.

Kötelező delegált hatókörök

Workspace.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Személyazonosság	Támogatás
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
folderId	path	True	string (uuid)	A mappa azonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Típus	Description
targetFolderId	string (uuid)	A célmappa azonosítója. Ha nincs megadva, a munkaterület lesz a célmappa.

Válaszok

Name	Típus	Description
200 OK	Folder	A kérés sikeresen befejeződött.
Other Status Codes	ErrorResponse	Gyakori hibakódok: FolderNotFound – Nem található a kért mappa. FolderDepthOutOfRange – A szülőmappa elérte a maximális mélységet, nem tud új almappát létrehozni. InfiniteFolderHierarchyLoop – A mappa nem helyezhető át egyik ereszkedőbe sem. FolderDisplayNameAlreadyInUse – A mappamegjelenítés neve már használatban van.

Példák

Move a folder into another folder example

Move a folder with the workspace as the destination example

Move a folder into another folder example

Mintakérelem

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

Mintaválasz

Állapotkód:

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

Mintakérelem

HTTP

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

{}

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
Folder	Mappaobjektum.
MoveFolderRequest	Mappakérelem áthelyezése.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

Folder

Objektum

Mappaobjektum.

Name	Típus	Description
displayName	string	A mappa megjelenítendő neve.
id	string (uuid)	A mappa azonosítója.
parentFolderId	string (uuid)	A szülőmappa azonosítója. Ha a szülőmappa munkaterület, akkor a parentFolderId nincs megadva, vagy null értékű.
workspaceId	string (uuid)	A munkaterület azonosítója.

MoveFolderRequest

Objektum

Mappakérelem áthelyezése.

Name	Típus	Description
targetFolderId	string (uuid)	A célmappa azonosítója. Ha nincs megadva, a munkaterület lesz a célmappa.