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 conteneurs SharePoint Embedded lorsqu’un conteneur doit être conservé, mais qu’il n’a plus besoin d’être activement accessible 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 une 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 des locataires avant d’exposer les actions d’archivage aux utilisateurs.
Activer l’archivage sur un type de conteneur
L’archivage doit être activé sur le type de conteneur. Utilisez SharePoint Embedded Administration PowerShell 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
Afficher 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 Microsoft Graph pour le conteneur cible.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive
L’appelant doit avoir le rôle ou PrincipalOwner sur Owner le conteneur. Les administrateurs globaux 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 jusqu’à ce qu’il soit réactivé. Arrêtez les téléchargements, les processeurs d’arrière-plan, les flux de travail dépendants des webhooks et les modifications interactives avant d’envoyer la demande d’archivage.
Obtenir des conteneurs archivés
Lire les propriétés standard d’un conteneur archivé avec l’opération get de conteneur v1.0.
GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers/{containerId}
Pour inspecter l’état d’archivage du conteneur, utilisez le point de terminaison bêta et sélectionnez archivalDetails.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}?$select=id,displayName,archivalDetails
Remarque
Les actions d’archivage et d’annulation d’archivage et la propriété archivalDetails sont disponibles uniquement dans la version bêta de Microsoft Graph. Conserver les requêtes qui lisent ou filtrent sur archivalDetails , /betamême si les opérations standard d’obtention et de liste des conteneurs sont disponibles dans v1.0.
Répertoriez 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 de l’archivage de la version 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 au cours des sept premiers jours suivant 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.
Contrôles du cycle de vie de la conception
Exiger l’intention explicite de l’utilisateur avant d’archiver et d’annuler les demandes d’archivage. Enregistrez l’ID de conteneur, l’acteur, l’horodatage et les données de corrélation des requêtes Graph dans les journaux de vos applications. Ne traitez pas l’archive comme une suppression ; les exigences en matière de rétention, d’eDiscovery, d’audit et de conformité s’appliquent toujours aux données archivées.
En cas d’échec d’une opération sur le cycle de vie, case activée le rôle de l’appelant, l’autorisation d’écriture de l’application, le paramètre d’archivage du type de conteneur et vérifiez si le conteneur cible est déjà dans l’état demandé.