Folders - Create Folder

Service:

Core

API-versie:

v1

Notitie

Deze API is een preview-versie.

Hiermee maakt u een map in de opgegeven werkruimte.

Machtigingen

De aanroeper moet inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Ondersteuning
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

gebruikersinterface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

Name	Vereist	Type	Description
displayName	True	string	De weergavenaam van de map. De naam moet voldoen aan mapnaamvereisten
parentFolderId		string (uuid)	De id van de bovenliggende map. Als deze niet is opgegeven of null, wordt de map gemaakt met de werkruimte als bovenliggende map.

Antwoorden

Name	Type	Description
201 Created	Folder	Gemaakt
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: FolderDisplayNameAlreadyInUse - Weergavenaam van map wordt al gebruikt. FolderNotFound : de aangevraagde map is niet gevonden in de werkruimte. InvalidFolderDisplayName : de opgegeven weergavenaam van de map is ongeldig. FolderDepthOutOfRange - De bovenliggende map heeft maximale diepte bereikt, kan geen nieuwe submap maken. WorkspaceNotSupported - Het opgegeven werkruimtetype biedt geen ondersteuning voor map .* TooManyFolders : de opgegeven werkruimte heeft het maximumaantal mappen bereikt, kan niet meer worden gemaakt.

Voorbeelden

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

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

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

Voorbeeldaanvraag

HTTP

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

{
  "displayName": "A folder"
}

Voorbeeldrespons

Statuscode:

201

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

Definities

Name	Description
CreateFolderRequest	Nettolading voor mapaanvragen maken.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
Folder	Een mapobject.

CreateFolderRequest

Object

Nettolading voor mapaanvragen maken.

Name	Type	Description
displayName	string	De weergavenaam van de map. De naam moet voldoen aan mapnaamvereisten
parentFolderId	string (uuid)	De id van de bovenliggende map. Als deze niet is opgegeven of null, wordt de map gemaakt met de werkruimte als bovenliggende map.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

Folder

Object

Een mapobject.

Name	Type	Description
displayName	string	De weergavenaam van de map.
id	string (uuid)	De map-id.
parentFolderId	string (uuid)	De id van de bovenliggende map. Als de bovenliggende map een werkruimte is, is parentFolderId niet opgegeven of null.
workspaceId	string (uuid)	De werkruimte-id.