Freigeben über


Wiederherstellen oder dauerhaftes Löschen von Elementen (Vorschau)

Fabric unterstützt das Soft Delete und die Wiederherstellung einzelner Elemente in Arbeitsbereichen. Wenn Sie ein unterstütztes Element löschen, wird ein Aufbewahrungszeitraum eingegeben, in dem Arbeitsbereichsmitwirkende, Mitglieder und Administratoren es wiederherstellen können. Dieser Schutz trägt dazu bei, versehentlichen Datenverlust zu verhindern, indem Sie die Möglichkeit erhalten, Elemente wiederherzustellen, bevor sie endgültig entfernt werden.

In diesem Artikel erfahren Sie, wie Sie die Aufbewahrung von Elementen einrichten, gelöschte Elemente wiederherstellen und Elemente endgültig löschen, bevor der Aufbewahrungszeitraum abläuft.

Eine Übersicht über die Funktionsweise der Aufbewahrung für Arbeitsbereiche und Elemente finden Sie unter Aufbewahrung und Wiederherstellung in Fabric.

Von Bedeutung

Vorläufiges Löschen auf Elementebene und Wiederherstellung befinden sich derzeit in der VORSCHAU. Diese Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der Veröffentlichung erheblich geändert werden kann. Microsoft übernimmt keine Gewährleistungen, ausgedrückt oder impliziert, in Bezug auf die hier bereitgestellten Informationen.

Voraussetzungen

  • Zum Einrichten von Aufbewahrungseinstellungen für Elemente benötigen Sie eine Mandantenadministratorrolle .
  • Um gelöschte Elemente wiederherzustellen, benötigen Sie mindestens Arbeitsbereichsmitwirkendeberechtigungen . Siehe Berechtigungen für die vollständige Berechtigungsmatrix.
  • Um wiederherstellbare Elemente dauerhaft zu löschen, benötigen Sie Arbeitsbereichsadministratorberechtigungen .

Einrichten des Aufbewahrungszeitraums für gelöschte Elemente

Wenn Sie die Elementwiederherstellung in Mandanteneinstellungen aktivieren, behält Fabric gelöschte Elemente standardmäßig sieben Tage lang bei. Sie können den Aufbewahrungszeitraum (von 7 bis 90 Tagen) mithilfe der Elementwiederherstellung-Mandanteneinstellung ändern.

  1. Wechseln Sie im Verwaltungsportal zu Mandanteneinstellungen>Elementwiederherstellung.
  2. Aktivieren Sie die Einstellung, und geben Sie die Anzahl der Tage für den Aufbewahrungszeitraum ein (7 bis 90 Tage).
  3. Wählen Sie Apply aus.

Hinweis

Wenn die Einstellung " Elementwiederherstellung " deaktiviert ist, behält Fabric beim Löschen eines einzelnen Elements keine gelöschten Elemente bei.

Die Einstellung "Elementwiederherstellung" wirkt sich nicht auf den Aufbewahrungszeitraum von Arbeitsbereichen aus. Ausführliche Informationen zur Aufbewahrung von Arbeitsbereichen finden Sie in Fabric unter Aufbewahrung und Wiederherstellung.

Wiederherstellen eines gelöschten Elements

Während sich ein gelöschtes Element in einem Aufbewahrungszeitraum befindet, können Arbeitsbereichsmitwirkende, Mitglieder und Administratoren es und seine Eigenschaften wiederherstellen.

Verwenden Sie den Papierkorb des Arbeitsbereichs, um ein Element wiederherzustellen.

Der Papierkorb des Arbeitsbereichs ist eine dedizierte Ansicht in jedem Arbeitsbereich, in der Sie vorläufig gelöschte Elemente durchsuchen, wiederherstellen oder endgültig löschen können.

  1. Öffnen Sie den Arbeitsbereich, der das gelöschte Element enthielt.
  2. Wählen Sie in der Arbeitsbereichsnavigation den Papierkorb aus.
  3. Suchen Sie das Element, das Sie wiederherstellen möchten. Sie können die Filter- und Suchoptionen verwenden, um bestimmte Elemente zu finden.
  4. Wählen Sie das Element aus, und wählen Sie dann auf der Symbolleiste " Wiederherstellen " aus.

Das wiederhergestellte Element wird wieder in seinem ursprünglichen Arbeitsbereich angezeigt, wobei seine Eigenschaften, Konfigurationen und Beziehungen intakt sind.

Verwenden der REST-API zum Wiederherstellen eines Elements

Verwenden Sie die REST-API, um gelöschte Elemente programmgesteuert wiederherzustellen.

Anforderung:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}/recover

Parameter:

  • workspaceId – Der eindeutige Bezeichner des Arbeitsbereichs, der das gelöschte Element enthält.
  • itemId - Der eindeutige Bezeichner des zu wiederherstellenden Elements.

Example:

curl --request POST \
  --url https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/recover \
  --header 'Authorization: Bearer {token}'

Antwort:

  • 200 OK – Element wurde erfolgreich wiederhergestellt.
  • 404 Nicht gefunden – Element nicht gefunden oder nicht mehr im Wiederherstellungszeitraum.
  • 403 Verboten – Der Benutzer verfügt nicht über die Berechtigung, das Element wiederherzustellen.

Hinweis

Wiederhergestellte Elemente behalten ihre ursprünglichen Eigenschaften, Einstellungen und Berechtigungen bei. Wenn das Element von anderen gelöschten Elementen abhängt, müssen Sie diese Abhängigkeiten möglicherweise zuerst wiederherstellen.

Von Bedeutung

Wenn ein neues Element mit demselben Namen wie das vorläufig gelöschte Element im selben Arbeitsbereich vorhanden ist, schlägt die Wiederherstellung fehl, bis Sie das vorhandene Element umbenennen. Um das gelöschte Element wiederherzustellen, benennen Sie das neue Element um, und wiederholen Sie dann den Wiederherstellungsvorgang.

Dauerhaftes Löschen eines wiederherstellbaren Elements

Während sich ein gelöschtes Element in seinem Aufbewahrungszeitraum befindet, können Sie es dauerhaft löschen, wenn Sie über Arbeitsbereichsadministratorberechtigungen verfügen.

Verwenden Sie den Papierkorb des Arbeitsbereichs, um ein Element endgültig zu löschen.

  1. Öffnen Sie den Arbeitsbereich, der das gelöschte Element enthielt.
  2. Wählen Sie in der Arbeitsbereichsnavigation den Papierkorb aus.
  3. Suchen Sie das Element, das Sie endgültig löschen möchten.
  4. Wählen Sie das Element aus, und wählen Sie dann "Endgültig löschen " aus der Symbolleiste aus.

Sie werden aufgefordert, die dauerhafte Löschung zu bestätigen. Nach der Bestätigung können das Element und dessen Inhalt nicht mehr wiederhergestellt werden.

Verwenden der REST-API zum endgültigen Löschen eines Elements

Verwenden Sie die REST-API, um Elemente während des Aufbewahrungszeitraums programmgesteuert zu löschen.

Anforderung:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}

Parameter:

  • workspaceId – Der eindeutige Bezeichner des Arbeitsbereichs, der das gelöschte Element enthält.
  • itemId - Der eindeutige Bezeichner des Elements, das endgültig gelöscht werden soll.

Example:

curl --request DELETE \
  --url https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2 \
  --header 'Authorization: Bearer {token}'

Warnung

Sie können einen dauerhaften Löschvorgang nicht rückgängigmachen.