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

Применяется к: Для разработчиков

В этой статье описываются два основных объекта хранения в 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 должно быть связано с контейнером этого типа. После ассоциации приложение получает доступ к контейнерам этого типа в соответствии с разрешениями типа application-container. Приложение-владелец по умолчанию обладает привилегией полного доступа к контейнерам того типа контейнера, с которым оно связано. Фактический доступ также зависит от того, использует ли приложение делегированный доступ или только доступ для приложений.

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

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

Использование пробного типа контейнера для изучения возможностей разработки 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 типов контейнеров. Один из них может быть бесплатным пробным типом контейнера, а остальные — стандартными типами контейнеров. Вы можете запросить повышение через службу поддержки Microsoft или через свое контактное лицо по подключению SharePoint Embedded.

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

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

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

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

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

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

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

Создайте тип контейнера с конечной точкой Microsoft GraphPOST /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

Используйте API обновления fileStorageContainerType в Microsoft Graph для обновлений поддерживаемых типов контейнеров. Сведения о параметрах администрирования см. в статье "Создание приложений с помощью PowerShell".

Регистрация

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

Приложение-владелец вызывает API регистрации, чтобы определить разрешения приложения для типа контейнера.

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

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

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

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

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