Condividi tramite


OneLake Data Access Security - Delete Data Access Role

Elimina un singolo ruolo di accesso ai dati.

Annotazioni

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.

Quando si chiama questa API, i chiamanti devono specificare true come valore per il parametro previewdi query .

Permissions

Il chiamante deve avere un ruolo membro o superiore nell'area di lavoro.

Ambiti delegati obbligatori

OneLake.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}/items/{itemId}/dataAccessRoles/{roleName}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
itemId
path True

string (uuid)

ID dell'elemento Fabric da cui eliminare il ruolo.

roleName
path True

string

Nome del ruolo da eliminare.

workspaceId
path True

string (uuid)

L’ID dell’area di lavoro.

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: indica che il server non riesce a trovare l'elemento richiesto.

  • RoleNotFound : indica che il ruolo specificato non è stato trovato.

Esempio

Delete data access role example

Esempio di richiesta

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/dataAccessRoles/DefaultReader

Risposta di esempio

Definizioni

Nome Descrizione
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.

ErrorResponse

Risposta di errore.

ErrorResponseDetails

Dettagli della risposta di errore.

ErrorRelatedResource

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

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

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.