Folders - Get Folder

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Palauttaa 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 katselija tai suurempi rooli työtilassa.

Vaaditut delegoidut vaikutusalueet

Workspace.Read.All tai 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

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

Vastaukset

Nimi	Tyyppi	Description
200 OK	Folder	Pyynnön valmistuttua.
Other Status Codes	ErrorResponse	Yleiset virhekoodit: FolderNotFound: pyydettyä kansiota ei löytynyt työtilasta.

Esimerkit

Get a folder example

Mallipyyntö

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/bbbbbbbb-1111-2222-3333-cccccccccccc

Mallivastaus

Tilakoodi:

200

{
  "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "displayName": "A nested folder",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb"
}

Määritelmät

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

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.