Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Entwickler
Verwenden Sie die SharePoint Embedded-Containerarchivierung, wenn ein Container beibehalten werden muss, aber nicht mehr aktiv darauf zugegriffen oder für die Zusammenarbeit verwendet werden muss. Archival verwendet Microsoft 365 Archiv, eine kalte Speicherebene, die Speicherkosten reduziert und gleichzeitig die gleichen Sicherheitsstandards, Compliance und Suchstandards einhält. Die Übersicht über microsoft 365 Archiv finden Sie unter Microsoft 365 Archiv.
Wichtig
Microsoft 365 Archiv befindet sich in der Vorschau für SharePoint Embedded. Überprüfen Sie die Verfügbarkeit, Abrechnung und das API-Verhalten des Mandanten, bevor Sie Archivaktionen für Benutzer verfügbar machen.
Aktivieren der Archivierung für einen Containertyp
Die Archivierung muss für den Containertyp aktiviert sein. Verwenden Sie SharePoint Embedded-Administrator-PowerShell für einen vorhandenen Containertyp.
Set-SPOContainerTypeConfiguration -ContainerTypeId <id> -IsArchiveEnabled $true
Aktivieren Sie die Archivierung, wenn Sie einen neuen Containertyp erstellen, indem Sie übergeben -IsArchiveEnabled $true.
New-SPOContainerType -ContainerTypeName <name> -OwningApplicationId <id> -IsArchiveEnabled $true
Zeigen Sie in Ihrer App nur Archivbefehle an, nachdem die besitzende Anwendung und der nutzende Mandant für den Containertyp konfiguriert wurden.
Archiv eines Containers
Rufen Sie die Microsoft Graph-Betaarchivaktion für den Zielcontainer auf.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive
Der Aufrufer muss über die Owner Rolle oder PrincipalOwner für den Container verfügen. Globale Administratoren und SharePoint Embedded-Administratoren können auf alle Container reagieren. Die App muss auch über Schreibberechtigungen für den Container verfügen.
Auf einen archivierten Container kann nicht zugegriffen werden, bis er erneut aktiviert wird. Beenden Sie Uploads, Hintergrundprozessoren, webhookabhängige Workflows und interaktive Bearbeitungen, bevor Sie die Archivanforderung übermitteln.
Abrufen archivierter Container
Lesen Sie einen archivierten Container mit dem normalen Container get-Vorgang.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}
Listen Sie archivierte Container für einen Containertyp auf, indem Sie nach Containern filtern, die Archivdetails enthalten.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and archivalDetails ne null
Verwenden Sie diese Liste für Lebenszyklusansichten, Administratorberichte oder Reaktivierungsflows. Machen Sie den archivierten Zustand auf Ihrer Benutzeroberfläche sichtbar, damit Benutzer verstehen, warum Dateien nicht geöffnet werden können.
Reaktivieren eines Containers
Rufen Sie die Microsoft Graph Beta-Aktion Zum Aufheben der Archivierung auf, um einen archivierten Container erneut zu aktivieren.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/unarchive
Die Reaktivierung erfolgt während der ersten sieben Tage nach der Archivierung sofort. Nach sieben Tagen kann die Reaktivierung bis zu 24 Stunden dauern. Lassen Sie die Lese- und Schreibaktionen des Containers deaktiviert, bis der Dienst meldet, dass der Container wieder aktiv ist.
Entwerfen von Lebenszyklussteuerelementen
Erfordert eine explizite Benutzerabsicht, bevor Anforderungen archiviert und die Archivierung aufgehoben werden. Notieren Sie sich die Korrelationsdaten für Container-ID, Akteur, Zeitstempel und Graph-Anforderung in Ihren Anwendungsprotokollen. Behandeln Sie Archiv nicht als Löschvorgang. Aufbewahrungs-, eDiscovery-, Überwachungs- und Complianceanforderungen gelten weiterhin für archivierte Daten.
Wenn ein Lebenszyklusvorgang fehlschlägt, überprüfen Sie die Aufruferrolle, die Schreibberechtigung der App, die Archivierungseinstellung des Containertyps und ob sich der Zielcontainer bereits im angeforderten Zustand befindet.