Condividi tramite

Items - Delete Item

Servizio:
Core
Versione API:
v1

Elimina l'elemento specificato.
Questa API è supportata per diversi tipi di elemento, trovare i tipi di elemento supportati e le informazioni sulla relativa struttura di definizione in panoramica della gestione degli elementi. Il comportamento predefinito consiste nell'eliminare leggero l'elemento per i tipi di elemento supportati.

Annotazioni

Gli elementi eliminati soft verranno conteggiati per il numero massimo di elementi consentiti in ogni area di lavoro.

Autorizzazioni

Il chiamante deve disporre delle autorizzazioni di scrittura per l'elemento per l'eliminazione temporanea. Il chiamante deve avere il ruolo di amministratore dell'area di lavoro assegnato per l'eliminazione definitiva/definitiva.

Ambiti delegati obbligatori

Per le API degli elementi, usare questi tipi di ambito:

  • Ambito generico: Item.ReadWrite.All
  • Ambito specifico: itemType. ReadWrite.All (ad esempio: Notebook.ReadWrite.All)

Per altre informazioni sugli ambiti, vedere l'articolo ambiti.

Identità supportate da Microsoft Entra

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

Identità Assistenza
Utente Sì
Principale del servizio e Identità gestite Quando il tipo di elemento nella chiamata è supportato. Controllare l'API corrispondente per il tipo di elemento che si sta chiamando per verificare se la chiamata è supportata. Ad esempio, i modelli semantici sono supportati.

Interfaccia

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}
Con parametri facoltativi: 
DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}?hardDelete={hardDelete}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
itemId
 path True

string (uuid)

ID elemento.
workspaceId
 path True

string (uuid)

L’ID dell’area di lavoro.
hardDelete
 query

boolean

Specifica se eseguire un'eliminazione complessa. Se impostato su true, l'elemento viene eliminato definitivamente e non può essere recuperato. Se impostato su false o non specificato, l'elemento viene eliminato soft se il tipo di elemento lo supporta.

Risposte

Nome Tipo Descrizione
200 OK

Richiesta completata correttamente.
429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • ItemNotFound: l'elemento richiesto non è stato trovato.

  • InsufficientWorkspaceRole: l'utente non ha un ruolo di area di lavoro sufficiente.

  • FeatureNotAvailable: potrebbe essere dovuto alla funzionalità di eliminazione temporanea non disponibile.

  • UnsupportedItemType: ciò potrebbe essere dovuto alla funzionalità di eliminazione temporanea non supportata dal tipo di elemento richiesto.

  • TenantSwitchDisabled: potrebbe essere dovuto alla funzionalità di eliminazione temporanea disabilitata dall'amministratore del tenant.

  • InvalidTargetItemStateForSoftDeletion: l'elemento è in stati non validi per l'eliminazione temporanea.

  • InvalidParentItemStateForSoftDeletion: l'elemento padre dell'elemento non è in stato Attivo.

Esempio

Delete an item example
Hard delete an item example

Delete an item example

Esempio di richiesta

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

Risposta di esempio

Codice di stato:
200

Hard delete an item example

Esempio di richiesta

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

Risposta di esempio

Codice di stato:
200

Definizioni

Nome Descrizione
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.

ErrorRelatedResource

Oggetto

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

Oggetto

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 (uuid)

ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

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.