Freigeben über

Sharing Links - Remove All Sharing Links

  • Referenz
Dienst:
Admin
API-Version:
v1

Hinweis

Diese API befindet sich in der Vorschau.

Löscht alle Organisationsfreigabelinks für alle Fabric-Elemente im Mandanten. Diese Aktion kann nicht rückgängig gemacht werden.
Diese API unterstützt LRO-.

Verwenden Sie linksSharedToWholeOrganization PowerBI Admin REST API, um Power BI-Berichte abzurufen, die über Organisationsfreigabelinks freigegeben werden.

Erlaubnisse

Der Aufrufer muss ein Fabric-Administrator sein.

Erforderliche delegierte Bereiche

Tenant.ReadWrite.All

Einschränkungen

  • Maximal 10 Anforderungen pro Minute.
  • Nur Power BI-Berichte werden unterstützt.

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

POST https://api.fabric.microsoft.com/v1/admin/items/removeAllSharingLinks

Anforderungstext

Name Erforderlich Typ Beschreibung
sharingLinkType True

SharingLinkType

Gibt den Typ des Freigabelinks an, der gelöscht werden muss. Zusätzliche Freigabelinktypen können im Laufe der Zeit hinzugefügt werden.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung wurde erfolgreich abgeschlossen.
202 Accepted

Anforderung angenommen. Das Abrufen der Definition wird ausgeführt.

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • Verboten – Der Aufrufer verfügt nicht über Berechtigungen zum Aufrufen der API.

Beispiele

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/admin/items/removeAllSharingLinks

{
  "sharingLinkType": "OrgLink"
}

Beispiel für eine Antwort

Statuscode:
200
Statuscode:
202 
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
RemoveAllSharingLinksRequest

Akzeptiert den Typ des Freigabelinks, der für alle Fabric-Elemente in der Organisation entfernt werden soll.
SharingLinkType

Gibt den Typ des Freigabelinks an, der für jedes Fabric-Element gelöscht werden muss. Zusätzliche Freigabelinktypen können im Laufe der Zeit hinzugefügt werden.

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.

RemoveAllSharingLinksRequest

Objekt

Akzeptiert den Typ des Freigabelinks, der für alle Fabric-Elemente in der Organisation entfernt werden soll.

Name Typ Beschreibung
sharingLinkType

SharingLinkType

Gibt den Typ des Freigabelinks an, der gelöscht werden muss. Zusätzliche Freigabelinktypen können im Laufe der Zeit hinzugefügt werden.

SharingLinkType

Enumeration

Gibt den Typ des Freigabelinks an, der für jedes Fabric-Element gelöscht werden muss. Zusätzliche Freigabelinktypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
OrgLink

Der Freigabelink gewährt Zugriff auf die gesamte Organisation (Standardwert).