Folders - Create Folder

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Luo kansion määritettyyn työtilaan.

Huomautus

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

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

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.

Identiteetti	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
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
parentFolderId		string (uuid)	Pääkansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, kansio luodaan niin, että työtila on sen pääkansio.

Vastaukset

Nimi	Tyyppi	Description
201 Created	Folder	Luonti onnistui
Other Status Codes	ErrorResponse	Yleiset virhekoodit: FolderDisplayNameAlreadyInUse - Kansion näyttönimi on jo käytössä. FolderNotFound: pyydettyä kansiota ei löytynyt työtilasta. InvalidFolderDisplayName – Annettu kansion näyttönimi on virheellinen. FolderDepthOutOfRange – Pääkansiossa on enimmäissyvyys. Et voi luoda uutta alikansiota. WorkspaceNotSupported – Määritetty työtilatyyppi ei tue Kansiota .* TooManyFolders – Määritetty työtila on saavuttanut kansioiden enimmäismäärän, mutta sitä ei voi enää luoda.

Esimerkit

Create a folder under another folder example

Create a folder with the workspace as its parent folder example

Create a folder under another folder example

Mallipyyntö

HTTP

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

{
  "displayName": "Q3",
  "parentFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Mallivastaus

Tilakoodi:

201

{
  "id": "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
  "displayName": "Q3",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Create a folder with the workspace as its parent folder example

Mallipyyntö

HTTP

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

{
  "displayName": "A folder"
}

Mallivastaus

Tilakoodi:

201

{
  "id": "eeeeeeee-4444-5555-6666-ffffffffffff",
  "displayName": "A folder",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

Määritelmät

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

CreateFolderRequest

Object

Luo kansiopyyntöjen tiedot.

Nimi	Tyyppi	Description
displayName	string	Kansion näyttönimi. Nimen on täytettävä Kansion nimivaatimukset
parentFolderId	string (uuid)	Pääkansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, kansio luodaan niin, että työtila on sen pääkansio.

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.