Создание контейнеров и управление ими

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

Создание контейнеров и управление ими после создания, регистрации и авторизации типа контейнера. Контейнеры — это базовая единица хранения в SharePoint Embedded.

Выполните настройку проверки подлинности и авторизации , прежде чем вызывать API-интерфейсы контейнеров.

Общие сведения о контейнерах

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

Контейнер:

• Принадлежит используемому клиенту Microsoft 365.
• Имеет неизменяемый идентификатор типа контейнера.
• Хранит содержимое для приложения.
• Определяет границу членства и разрешений.
• Доступ к ней осуществляется через Microsoft Graph.

Общие сведения об архитектуре см. в статье Архитектура приложения SharePoint Embedded.

Сведения о жизненном цикле

Типичный жизненный цикл контейнера включает:

1. Создайте контейнер.
2. Добавление или подтверждение участников.
3. Отправка файлов и управление ими.
4. Чтение или обновление метаданных контейнера.
5. Перезахлать контейнер, если он больше не активен.
6. При необходимости восстановите переработанный контейнер.
7. Окончательное удаление контейнеров во время очистки.

Продолжайте отправлять, скачивать файлы и управлять ими для операций с содержимым.

Предварительные условия

Перед созданием контейнеров убедитесь, что:

• Тип контейнера существует.
• Тип контейнера регистрируется в используемом клиенте.
• Приложение имеет согласие Microsoft Graph FileStorageContainer.Selected .
• Приложение имеет разрешения типа контейнера для операции.
• Для делегированных вызовов вошедшего пользователя можно получить необходимую роль контейнера.
• Для пробных типов контейнеров вы находитесь в пределах ограничений пробной версии.

Важно!

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

Выбор делегированного или только для приложения создания

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

Используйте доступ только для приложений, когда служба подготавливает контейнеры, нет пользователя и приложение имеет разрешение на создание контейнеров.

Примечание.

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

Создание контейнера

Используйте Microsoft Graph для создания контейнера хранилища файлов для зарегистрированного типа контейнера.

Каноническая форма API см. в разделе Создание файлаStorageContainer.

Этапы реализации:

1. Получение допустимого токена Microsoft Graph.
2. Включите сведения о целевом типе контейнера, необходимые API.
3. Отправьте запрос на создание.
4. Сохраните возвращенный идентификатор контейнера.
5. Хранить метаданные, необходимые приложению.
6. Назначение или подтверждение членства для делегированных сценариев.

Совет

Сохраните идентификатор контейнера в базе данных приложения в качестве надежной связи между бизнес-объектом и контейнером SharePoint Embedded.

Создание контейнера в Visual Studio Code

Для разработки пробной версии расширение Visual Studio Code может создавать контейнеры.

1. Откройте представление SharePoint Embedded.
2. Разверните тип контейнера зарегистрированной пробной версии.
3. Щелкните правой кнопкой мыши Контейнеры.
4. Выберите Создать контейнер.
5. Введите имя.
6. Убедитесь, что контейнер отображается под типом контейнера.

См. краткое руководство. Создание первого приложения с помощью VS Code для потока расширения.

Вывод списка контейнеров

Вывод списка контейнеров для отображения доступных контейнеров, проверки подготовки или запуска обслуживания.

Каноническая форма API см. в разделе Список контейнеров.

При перечислении контейнеров:

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

Примечание.

Контейнеры делегированного списка в настоящее время возвращаются 403 Forbidden , если у пользователя нет OneDrive. Эта зависимость не применяется к вызовам списка только для приложений.

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

Получите контейнер, если вам нужны последние метаданные, прежде чем действовать.

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

Связывание реализаций с типом ресурса fileStorageContainer.

Обновление метаданных контейнера

Обновление метаданных при изменении поддерживаемых свойств.

Перед обновлением:

1. Убедитесь, что приложение имеет разрешение на тип Write контейнера.
2. Убедитесь, что делегированный пользователь имеет соответствующую роль.
3. Чтение текущего состояния контейнера.
4. Применяйте только предполагаемые изменения.
5. Проверьте ответ.

Удаление или перезапуск контейнера

Перезапустить или удалить контейнер, если он больше не активен.

Перед удалением:

• Убедитесь, что вызывающий объект имеет разрешение.
• Убедитесь, что приложение содержит архивные бизнес-ссылки.
• Решите, следует ли сначала перезаработать контейнер.
• Сообщите пользователям, как восстановить переработанный контейнер.

Расширение Visual Studio Code включает возможности перезапуска и восстановления для разработки пробной версии.

Восстановление переработанного контейнера

Поток восстановления должен:

1. Определите переработанный контейнер.
2. Убедитесь, что вызывающий объект имеет разрешение.
3. Восстановите контейнер.
4. Обновление состояния приложения.
5. Убедитесь, что файлы и метаданные доступны.
6. Уведомление пользователя.

Важно!

Для пробных типов контейнеров контейнеры в корзине по-прежнему учитываются в пяти контейнерах.

Окончательное удаление контейнеров

Окончательное удаление, только если вы уверены, что контейнер больше не нужен.

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

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

Проверка операций жизненного цикла

Создайте тест дыма:

1. Создайте тестовый контейнер.
2. Извлеките его по идентификатору.
3. Вывод списка контейнеров и подтверждение их отображения.
4. Обновление поддерживаемого значения метаданных.
5. Отправьте небольшой файл.
6. Перезапустите или удалите контейнер.
7. Восстановите его, если поддерживается.
8. Окончательно удалите его во время очистки.

Устранение неполадок с жизненным циклом

Признак	Проверка
Сбой создания	Регистрация и Create разрешение.
Сбой делегированного создания	Согласие пользователя и поведение назначения ролей.
Сбой списка для делегированного пользователя	Зависимость OneDrive, указанная в статье проверки подлинности.
Сбой удаления	Delete разрешение и роль владельца пользователя.
Сбой создания пробной версии	Активные и переработанные контейнеры, возможно, достигли предела.
Сбой удаления типа контейнера	Сначала необходимо удалить все активные и удаленные контейнеры.

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

Добавьте операции с файлами в раздел Отправка, скачивание файлов и управление ими.