Folders - Create Folder

Servizio:

Core

Versione API:

v1

Crea una cartella nell'area di lavoro specificata.

Nota

Questa API fa parte di una versione di anteprima e viene fornita solo a scopo di valutazione e sviluppo. Può cambiare in base al feedback e non è consigliato per l'uso in produzione.

Autorizzazioni

Il chiamante deve avere ruolo collaboratore o superiore dell'area di lavoro.

Ambiti delegati obbligatori

Workspace.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità Microsoft elencate in questa sezione.

Identità	Assistenza
Utente	Sì
Entità servizio e identità gestite	Sì

Interfaccia

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string (uuid)	ID dell'area di lavoro.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
displayName	True	string	Nome visualizzato della cartella. Il nome deve soddisfare i requisiti Nome cartella
parentFolderId		string (uuid)	ID cartella padre. Se non specificato o null, la cartella viene creata con l'area di lavoro come cartella padre.

Risposte

Nome	Tipo	Descrizione
201 Created	Folder	Creazione completata
Other Status Codes	ErrorResponse	Codici di errore comuni: FolderDisplayNameAlreadyInUse - Nome visualizzato cartella già usato. FolderNotFound: la cartella richiesta non è stata trovata nell'area di lavoro. InvalidFolderDisplayName: il nome visualizzato della cartella specificato non è valido. FolderDepthOutOfRange: la cartella padre ha raggiunto la profondità massima, non può creare una nuova sottocartella. WorkspaceNotSupported: il tipo di area di lavoro specificato non supporta Folder .* TooManyFolders: l'area di lavoro specificata ha raggiunto il numero massimo di cartelle, non può più creare.

Esempio

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

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

HTTP

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

{
  "displayName": "A folder"
}

Risposta di esempio

Codice di stato:

201

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

Definizioni

Nome	Descrizione
CreateFolderRequest	Creare il payload della richiesta di cartella.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
Folder	Oggetto cartella.

CreateFolderRequest

Object

Creare il payload della richiesta di cartella.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato della cartella. Il nome deve soddisfare i requisiti Nome cartella
parentFolderId	string (uuid)	ID cartella padre. Se non specificato o null, la cartella viene creata con l'area di lavoro come cartella padre.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

Folder

Object

Oggetto cartella.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato della cartella.
id	string (uuid)	ID cartella.
parentFolderId	string (uuid)	ID cartella padre. Se la cartella padre è un'area di lavoro, parentFolderId non è specificato o null.
workspaceId	string (uuid)	ID dell'area di lavoro.