Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Développeur
Utilisez l’archivage de conteneur SharePoint Embedded lorsqu’un conteneur doit être conservé, mais qu’il n’est plus nécessaire d’être actif ou utilisé pour la collaboration. L’archivage utilise Microsoft 365 Archive, un niveau de stockage froid qui réduit les coûts de stockage tout en conservant les mêmes normes de sécurité, de conformité et de recherche. Pour obtenir la vue d’ensemble de Microsoft 365 Archive, consultez Microsoft 365 Archive.
Importante
Microsoft 365 Archive est en préversion pour SharePoint Embedded. Validez la disponibilité, la facturation et le comportement de l’API du locataire avant d’exposer des actions d’archivage aux utilisateurs.
Activer l’archivage sur un type de conteneur
L’archivage doit être activé sur le type de conteneur. Utilisez PowerShell administrateur SharePoint Embedded pour un type de conteneur existant.
Set-SPOContainerTypeConfiguration -ContainerTypeId <id> -IsArchiveEnabled $true
Activez l’archivage lorsque vous créez un type de conteneur en transmettant -IsArchiveEnabled $true.
New-SPOContainerType -ContainerTypeName <name> -OwningApplicationId <id> -IsArchiveEnabled $true
Affichez uniquement les commandes d’archivage dans votre application une fois que l’application propriétaire et le locataire consommateur sont configurés pour le type de conteneur.
Archive un conteneur
Appelez l’action d’archivage bêta de Microsoft Graph pour le conteneur cible.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive
L’appelant doit avoir le Owner rôle ou PrincipalOwner sur le conteneur. Les administrateurs généraux et les administrateurs SharePoint Embedded peuvent agir sur tous les conteneurs. L’application doit également disposer d’une autorisation d’écriture sur le conteneur.
Un conteneur archivé est inaccessible tant qu’il n’est pas réactivé. Arrêtez les chargements, les processeurs en arrière-plan, les workflows dépendants du webhook et les modifications interactives avant d’envoyer la demande d’archivage.
Obtenir des conteneurs archivés
Lisez un conteneur archivé avec l’opération d’obtention de conteneur normale.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}
Répertorier les conteneurs archivés pour un type de conteneur en filtrant les conteneurs qui ont des détails d’archivage.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and archivalDetails ne null
Utilisez cette liste pour les vues de cycle de vie, les rapports d’administration ou les flux de réactivation. Rendez l’état archivé visible dans votre interface utilisateur afin que les utilisateurs comprennent pourquoi les fichiers ne peuvent pas être ouverts.
Réactiver un conteneur
Appelez l’action d’annulation d’archivage bêta de Microsoft Graph pour réactiver un conteneur archivé.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/unarchive
La réactivation est instantanée pendant les sept premiers jours après l’archivage. Après sept jours, la réactivation peut prendre jusqu’à 24 heures. Conservez les actions de lecture et d’écriture du conteneur désactivées jusqu’à ce que le service signale que le conteneur est à nouveau actif.
Concevoir des contrôles de cycle de vie
Exiger une intention explicite de l’utilisateur avant les demandes d’archivage et d’archivage. Enregistrez l’ID de conteneur, l’acteur, l’horodatage et les données de corrélation des requêtes Graph dans vos journaux d’application. Ne traitez pas l’archive comme une suppression ; Les exigences de rétention, d’eDiscovery, d’audit et de conformité s’appliquent toujours aux données archivées.
Si une opération de cycle de vie échoue, case activée le rôle d’appelant, l’autorisation d’écriture d’application, le paramètre d’archivage du type de conteneur et si le conteneur cible est déjà dans l’état demandé.