Folders - Create Folder

Tjeneste:

Core

API-versjon:

v1

Oppretter en mappe i det angitte arbeidsområdet.

Note

Denne API-en er en del av en forhåndsversjon, og er bare tilgjengelig for evaluerings- og utviklingsformål. Det kan endres basert på tilbakemelding og anbefales ikke for produksjonsbruk.

Permissions

Innringeren må ha bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Workspace.ReadWrite.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identity	Support
User	Yes
tjenestekontohaver og administrerte identiteter	Yes

Interface

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn	Obligatorisk	Type	Beskrivelse
displayName	True	string	Mappevisningsnavnet. Navnet må oppfylle krav til mappenavn
parentFolderId		string (uuid)	Den overordnede mappe-ID-en. Hvis den ikke er angitt eller null, opprettes mappen med arbeidsområdet som overordnet mappe.

Svar

Navn	Type	Beskrivelse
201 Created	Folder	Opprettet
Other Status Codes	ErrorResponse	Vanlige feilkoder: FolderDisplayNameAlreadyInUse – mappevisningsnavnet er allerede brukt. FolderNotFound – Finner ikke den forespurte mappen i arbeidsområdet. InvalidFolderDisplayName – angitt mappevisningsnavn er ugyldig. FolderDepthOutOfRange – Den overordnede mappen har oppnådd maksimal dybde, kan ikke opprette en ny undermappe. WorkspaceNotSupported – den angitte arbeidsområdetypen støtter ikke mappe .* TooManyFolders – det angitte arbeidsområdet har nådd maksimalt antall mapper, kan ikke opprette flere.

Eksempler

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

Eksempelforespørsel

HTTP

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

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

Eksempelsvar

Statuskode:

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

Eksempelforespørsel

HTTP

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

{
  "displayName": "A folder"
}

Eksempelsvar

Statuskode:

201

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

Definisjoner

Navn	Beskrivelse
CreateFolderRequest	Opprett nyttelast for mappeforespørsel.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
Folder	Et mappeobjekt.

CreateFolderRequest

Object

Opprett nyttelast for mappeforespørsel.

Navn	Type	Beskrivelse
displayName	string	Mappevisningsnavnet. Navnet må oppfylle krav til mappenavn
parentFolderId	string (uuid)	Den overordnede mappe-ID-en. Hvis den ikke er angitt eller null, opprettes mappen med arbeidsområdet som overordnet mappe.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

Folder

Object

Et mappeobjekt.

Navn	Type	Beskrivelse
displayName	string	Mappevisningsnavnet.
id	string (uuid)	Mappe-ID-en.
parentFolderId	string (uuid)	Den overordnede mappe-ID-en. Hvis den overordnede mappen er et arbeidsområde, er parentFolderId enten ikke angitt eller null.
workspaceId	string (uuid)	Arbeidsområde-ID-en.