Freigeben über

External Data Shares Provider - Delete External Data Share

Dienst:
Core
API-Version:
v1

Löscht die angegebene externe Datenfreigabe.

Erlaubnisse

Der Aufrufer muss über Lese - und Freigabeberechtigungen für das Element verfügen.

Erforderliche delegierte Bereiche

Element-APIs können einen der folgenden Bereiche in ihrem Token enthalten:

  • Allgemeiner Bereich: Item.ExternalDataShare.All
  • Bestimmter Bereich: itemType. ExternalDataShare.All, z. B.: Lakehouse.ExternalDataShare.All

Weitere Informationen zu Bereichen finden Sie in Bereichsartikel.

Erforderliche Mandanteneinstellungen

Um diese API zu verwenden, aktivieren Sie den Administratorwechsel für die externe Datenfreigabe für den Aufrufprinzipal.

Einschränkungen

Maximal 10 Anforderungen pro Minute.

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Unterstützung
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
externalDataShareId
 path True

string (uuid)

Die ID der externen Datenfreigabe.
itemId
 path True

string (uuid)

Die Element-ID.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Delete external data share example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.