Архив и восстановление контейнеров

Применимо к: Разработчик

Используйте архивацию контейнеров SharePoint Embedded, когда контейнер должен храниться, но больше не требует активного доступа или использования для совместной работы. Для архивации используется microsoft 365 Архив, уровень холодного хранилища, который снижает затраты на хранение, сохраняя одинаковые стандарты безопасности, соответствия требованиям и поиска. Обзор Архив Microsoft 365 см. в статье Microsoft 365 Архив.

Важно!

Microsoft 365 Архив доступна в предварительной версии для SharePoint Embedded. Проверьте доступность клиента, выставление счетов и поведение API, прежде чем предоставлять пользователям архивные действия.

Включение архивации для типа контейнера

Для типа контейнера должна быть включена архивация. Используйте PowerShell для администратора SharePoint Embedded для существующего типа контейнера.

Set-SPOContainerTypeConfiguration -ContainerTypeId <id> -IsArchiveEnabled $true

Включите архивацию при создании нового типа контейнера путем передачи -IsArchiveEnabled $true.

New-SPOContainerType -ContainerTypeName <name> -OwningApplicationId <id> -IsArchiveEnabled $true

Показывать команды архивирования в приложении только после того, как приложение-владеющее и потребляющее клиент настроены для типа контейнера.

Архив контейнера

Вызовите действие бета-версии архива Microsoft Graph для целевого контейнера.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive

Вызывающий объект должен иметь Owner роль или PrincipalOwner в контейнере. Глобальные администраторы и администраторы SharePoint Embedded могут работать со всеми контейнерами. Приложение также должно иметь разрешение на запись в контейнере.

Архивированный контейнер недоступен до повторной активации. Остановите отправку, фоновые процессоры, рабочие процессы, зависящие от веб-перехватчиков, и интерактивные изменения перед отправкой запроса архива.

Получение архивированных контейнеров

Чтение одного архивного контейнера с обычной операцией получения контейнера.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}

Вывод списка архивных контейнеров для типа контейнера путем фильтрации контейнеров с архивными сведениями.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and archivalDetails ne null

Используйте этот список для представлений жизненного цикла, административных отчетов или потоков повторной активации. Сделайте архивное состояние видимым в пользовательском интерфейсе, чтобы пользователи понимали, почему не удается открыть файлы.

Повторная активация контейнера

Вызовите действие бета-версии Microsoft Graph для повторной активации архивного контейнера.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/unarchive

Повторная активация выполняется мгновенно в течение первых семи дней после архивации. Через семь дней повторная активация может занять до 24 часов. Не отключите действия чтения и записи контейнера, пока служба не сообщит о том, что контейнер снова активен.

Элементы управления жизненным циклом разработки

Требовать явное намерение пользователя перед архивными и неархивными запросами. Запишите идентификатор контейнера, субъект, метку времени и данные корреляции запросов Graph в журналах приложения. Не рассматривайте архив как удаление; Требования к хранению, обнаружению электронных данных, аудиту и соответствию по-прежнему применяются к архивным данным.

Если операция жизненного цикла завершается сбоем, проверка роль вызывающего объекта, разрешение на запись приложения, параметр архивации типа контейнера и указывает, находится ли целевой контейнер в запрошенном состоянии.

Дальнейшие действия

  • Last updated on