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

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

Используйте эту статью, чтобы понять два основных объекта хранилища в SharePoint Embedded: типы контейнеров и контейнеры.

Полный справочник по созданию и управлению см. в статье Типы контейнеров SharePoint Embedded.

Объектная модель

SharePoint Embedded хранит файлы и документы в контейнерах, которые группируются по типам контейнеров. Вы создаете тип контейнера, прежде чем создавать контейнеры для приложения.

Объект	Что он представляет	Кто обычно управляет им
Тип контейнера	Связь между приложением и набором контейнеров, включая доступ, поведение и отчетность по выставлению счетов.	Разработчик или владелец типа контейнера.
Container	Граница хранилища и безопасности для файлов и папок.	Применение с помощью Microsoft Graph и администраторов для операций управления.

Концепция типа контейнера

Тип контейнера — это ресурс SharePoint Embedded. Он определяет:

• Владеющее приложение.
• Привилегии доступа между приложениями и контейнерами.
• Модель выставления счетов.
• Выбранные варианты поведения, применяемые к контейнерам этого типа.

Каждый тип контейнера тесно связан с одним приложением SharePoint Embedded, которое называется собственным приложением. Для SharePoint Embedded требуется связь 1:1 между приложением-владельцем и типом контейнера. Разработчик приложения-владелец отвечает за создание типа контейнера и управление ими.

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

Тип контейнера представлен в каждом контейнере как неизменяемое свойство с именем ContainerTypeID. Свойство используется в экосистеме SharePoint Embedded. Это влияет на:

• Авторизация доступа.
• Пробное исследование.
• Выставления счетов.
• Настраиваемое поведение.

Важно!

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

Контейнеры

Контейнер — это базовая единица хранения в SharePoint Embedded, определяющая границу безопасности и соответствия требованиям. Приложения создают контейнеры в потребляющих клиентах с помощью Microsoft Graph.

Files, папки, метаданные, версии и содержимое корзины хранятся в контейнерах и распространяются на текущие ограничения SharePoint Embedded.

Сведения об ограничениях см. в статье Общие сведения об ограничениях и шаблонах вызовов.

Собственность

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

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

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

Авторизация доступа

Приложение SharePoint Embedded должно быть связано с типом контейнера для доступа к контейнерам этого типа. После сопоставления приложение имеет доступ к контейнерам этого типа в соответствии с разрешениями типа контейнера приложения. Владеющее приложение по умолчанию имеет полный доступ к контейнерам типа, с которым оно сопряжено. Фактический доступ также зависит от того, использует ли приложение делегированный доступ или доступ только для приложения.

Сведения о планировании разрешений см. в статье Планирование проверки подлинности и разрешений.

Пробные типы контейнеров

Использование пробного типа контейнера для изучения разработки SharePoint Embedded без привязки Azure профиля выставления счетов.

Для пробных типов контейнеров:

• Клиент разработчика совпадает с клиентом, который использует его.
• Каждый разработчик может одновременно иметь только один тип контейнера пробной версии в клиенте.
• Пробная версия действительна в течение 30 дней.
• Можно создать до пяти контейнеров типа контейнера, включая активные контейнеры и контейнеры в корзине.
• Каждый контейнер имеет до 1 ГБ хранилища.
• Тип контейнера ограничен клиентом разработчика.

Тип контейнера пробной версии нельзя преобразовать в рабочую среду.

Чтобы создать пробный тип контейнера, разработчики могут использовать расширение SharePoint Embedded Visual Studio Code или API типа контейнера Microsoft Graph.

Типы контейнеров создаются с помощью конечной точки Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes с использованием классификации выставления trial счетов. Для этого вызова требуется FileStorageContainerType.Manage.All делегированное разрешение; доступ только для приложений не поддерживается. Вызывающий пользователь должен быть не гостевым членом клиента разработчика (не требуется роль администратора) и автоматически назначается в качестве владельца нового типа контейнера.

Типы контейнеров Standard

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

По умолчанию каждый клиент может иметь 25 типов контейнеров одновременно; один из них может быть типом контейнера бесплатной пробной версии, а остальные — стандартными типами контейнеров. Вы можете запросить увеличение через службу поддержки Майкрософт или через контакт по подключению SharePoint Embedded.

Standard типы контейнеров оплачиваются и должны использовать модель выставления счетов.

SharePoint Embedded поддерживает:

• Standard выставление счетов (standardклассификация выставления счетов).
• Сквозное выставление счетов (directToCustomer классификация выставления счетов).

Сведения о выборе выставления счетов см. в разделе Выбор модели выставления счетов.

тип контейнера выставления счетов Standard

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

Клиент разработчика присоединяет профиль выставления счетов после создания стандартного типа контейнера.

Создайте тип контейнера с конечной точкой Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes с помощью классификации standard выставления счетов, а затем вложите Azure профиль выставления счетов:

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "standard"
}

Тип контейнера сквозного выставления счетов

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

Разработчик создает тип контейнера с классификацией выставления directToCustomer счетов и не присоединяет профиль выставления счетов в клиенте разработчика.

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "directToCustomer"
}

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

взаимодействие Администратор и разработчиков

Разработчики и администраторы взаимодействуют с разными уровнями.

Действие	Тип контейнера	Container
Создание семейства хранилищ приложения	Да	Нет
Настройка отношения владения приложением	Да	Нет
Настройка отчетности по выставлению счетов	Да	Нет
Создание экземпляров хранилища приложений	Нет	Да
Хранение файлов и папок	Нет	Да
Применение системы управления для конкретных контейнеров	Нет	Да
Удаление семейства хранилищ	Да, после удаления контейнеров	Нет

Конфигурация типа контейнера

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

Вы можете настроить следующие параметры типа контейнера:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Используйте ФАЙЛ обновления Microsoft Graph API-интерфейс AzureContainerType для поддерживаемых обновлений типов контейнеров. Сведения об административных параметрах см. в статье Создание приложений с помощью PowerShell.

Регистрация

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

Владеющее приложение вызывает API регистрации для определения разрешений приложения для типа контейнера.

Полные сведения см. в разделе Регистрация разрешений приложения типа контейнера хранилища файлов.

Контрольный список планирования

• Выберите пробную или стандартную версию.
• Выберите стандартное выставление счетов или сквозное выставление счетов для рабочей среды.
• Определите владеющее приложение.
• Подтвердите имя типа контейнера.
• Подтвердите потребляющий клиент или арендаторы.
• Планирование регистрации типа контейнера.
• Планирование разрешений приложения.
• Планирование необходимых параметров типа контейнера.
• Планирование жизненного цикла контейнера и удаление.

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

Планирование проверки подлинности и авторизации. Планирование проверки подлинности и разрешений.