Items - Delete Map

Servizio:
Map
Versione API:
v1

Elimina la mappa specificata.

Permissions

Il chiamante deve disporre delle autorizzazioni di scrittura per la mappa.

Ambiti delegati obbligatori

Item.ReadWrite.All

Identità supportate da Microsoft Entra

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

Identità Support
User Yes
Principale del servizio e Identità gestite Yes

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
mapId
 path True

string (uuid)

ID mappa.
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 a Map example
Hard delete a Map example

Delete a Map example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200

Hard delete a Map example

Esempio di richiesta

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/maps/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.
isRetriable

boolean

Se true, la richiesta può essere ritentata. Usare l'intestazione della Retry-After risposta per determinare il ritardo, se disponibile.
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.