Folders - Move Folder

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Siirtää määritetyn kansion samassa työtilassa.

Note

Tämä ohjelmointirajapinta on osa esikatseluversiota, ja se on saatavilla vain arviointi- ja kehitystarkoituksiin. Muutos saattaa perustua palautteeseen, eikä sitä suositella tuotantokäyttöön.

Permissions

Kutsujalla on oltava osallistuja tai korkeampi rooli työtilassa.

Vaaditut delegoidut vaikutusalueet

Workspace.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identity	Support
User	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Interface

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
folderId	path	True	string (uuid)	Kansion tunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Tyyppi	Description
targetFolderId	string (uuid)	Kohdekansion tunnus. Jos tätä ei anneta, työtilaa käytetään kohdekansiona.

Vastaukset

Nimi	Tyyppi	Description
200 OK	Folder	Pyynnön valmistuttua.
Other Status Codes	ErrorResponse	Yleiset virhekoodit: FolderNotFound – Pyydettyä kansiota ei löydy. FolderDepthOutOfRange – Pääkansiossa on enimmäissyvyys. Et voi luoda uutta alikansiota. InfiniteFolderHierarchyLoop - Kansiota ei voi siirtää mihinkään sen laskuihin. FolderDisplayNameAlreadyInUse - Kansion näyttönimi on jo käytössä.

Esimerkit

Move a folder into another folder example

Move a folder with the workspace as the destination example

Move a folder into another folder example

Mallipyyntö

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

Mallivastaus

Tilakoodi:

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

Mallipyyntö

HTTP

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

{}

Mallivastaus

Tilakoodi:

200

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

Määritelmät

Nimi	Description
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
Folder	Kansio-objekti.
MoveFolderRequest	Siirrä kansiopyyntö.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

Folder

Object

Kansio-objekti.

Nimi	Tyyppi	Description
displayName	string	Kansion näyttönimi.
id	string (uuid)	Kansion tunnus.
parentFolderId	string (uuid)	Pääkansion tunnus. Jos pääkansio on työtila, parentFolderId ei ole määritetty tai se on tyhjäarvo.
workspaceId	string (uuid)	Työtilan tunnus.

MoveFolderRequest

Object

Siirrä kansiopyyntö.

Nimi	Tyyppi	Description
targetFolderId	string (uuid)	Kohdekansion tunnus. Jos tätä ei anneta, työtilaa käytetään kohdekansiona.