External Data Shares Provider - Revoke External Data Share

Servizio:

Core

Versione API:

v1

Revoca la condivisione dati esterna specificata. Questa azione non può essere annullata.

Autorizzazioni

Il chiamante deve disporre delle autorizzazioni di lettura e ricondivisione per l'elemento.

Ambiti delegati obbligatori

Le API degli elementi possono avere uno di questi ambiti nel token:

• Ambito generico: Item.ExternalDataShare.All
• Ambito specifico: itemType. ExternalDataShare.All, ad esempio: Lakehouse.ExternalDataShare.All

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

Impostazioni tenant necessarie

Per usare questa API, abilitare l'opzione amministratore condivisione dati esterna per l'entità chiamante.

Limitazioni

Massimo 10 richieste al minuto.

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	Sì

Interfaccia

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/externalDataShares/{externalDataShareId}/revoke

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
externalDataShareId	path	True	string (uuid)	ID condivisione dati esterna.
itemId	path	True	string (uuid)	ID elemento.
workspaceId	path	True	string (uuid)	L’ID dell’area di lavoro.

Risposte

Nome	Tipo	Descrizione
200 OK		Richiesta completata correttamente.
Other Status Codes	ErrorResponse	Codici di errore comuni: UnknownError: si è verificato un errore.

Esempio

Revoke external data share example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/externalDataShares/dccc162f-7a41-4720-83c3-5c7e81187959/revoke

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

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.