Folders - Update Folder

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Päivittää määritetyn kansion ominaisuudet.

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

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

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	Pakollinen	Tyyppi	Description
displayName	True	string	Kansion näyttönimi. Nimen on täytettävä Kansion nimivaatimukset

Vastaukset

Nimi	Tyyppi	Description
200 OK	Folder	Pyynnön valmistuttua.
Other Status Codes	ErrorResponse	Yleiset virhekoodit: FolderNotFound: pyydettyä kansiota ei löytynyt työtilasta. FolderDisplayNameAlreadyInUse - Kansion näyttönimi on jo käytössä. InvalidFolderDisplayName– Annettu kansion nimi on virheellinen, kuten virheelliset chars-arvot mukaan lukien.

Esimerkit

Update a folder example

Mallipyyntö

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb

{
  "displayName": "A new Folder name"
}

Mallivastaus

Tilakoodi:

200

{
  "id": "aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb",
  "displayName": "A new Folder name",
  "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.
UpdateFolderRequest	Päivitä 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.

UpdateFolderRequest

Object

Päivitä kansiopyyntö.

Nimi	Tyyppi	Description
displayName	string	Kansion näyttönimi. Nimen on täytettävä Kansion nimivaatimukset