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

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

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

Если вы только начинаете работу, выполните краткое руководство. Создание первого приложения с помощью VS Code. Затем используйте эту статью для пробных, стандартных и сквозных решений.

Чтобы выбрать между однотенантными и мультитенантными моделями, см. статью Выбор модели приложения.

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

Тип контейнера тесно связан с одним приложением Microsoft Entra ID, называемым приложением-владельцем.

Для SharePoint Embedded требуется связь "один к одному" между одним приложением-владельцем и одним типом контейнера.

Идентификатор типа контейнера хранится в каждом контейнере в виде неизменяемого свойства.

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

Примечание.

Microsoft API Graph — Create fileStorageContainerType — является делегированным и может вызываться любым пользователем, не владеющим гостевым клиентом. Вызывающему объекту не требуется роль администратора и автоматически назначается в качестве владельца нового типа контейнера.

Выберите пробную или рабочую версию

Выберите назначение типа контейнера при его создании.

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

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

Вариант использования	Тип контейнера
Локальное подтверждение концепции	Тип контейнера пробной версии
Владелец приложения платит	Standard тип контейнера с профилем выставления счетов
Клиент платит	Standard тип контейнера с сквозным выставлением счетов

Важно!

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

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

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

• Доступный клиент Microsoft 365 с SharePoint.
• Microsoft Entra ID регистрации приложения-владельце.
• Учетная запись участника, не являющегося гостевым, в арендаторе-владельце.
• Для стандартного выставления счетов Azure подписка и группа ресурсов.
• Для стандартной настройки выставления счетов владелец или участник разрешения на Azure подписку.

Примечание.

• Для создания типа контейнера с помощью Microsoft Graph требуется FileStorageContainerType.Manage.All только делегированное разрешение. Любой пользователь, не являющийся гостевым, в арендаторе-владельцем может создать его и автоматически назначается в качестве владельца этого типа контейнера. Сведения об административных операциях на уровне клиента см. в статье Создание приложений с помощью PowerShell.

• Пользователи, которые проходят проверку подлинности в контейнерах, должны существовать в Microsoft Entra ID в качестве членов или гостей. Лицензия Office не требуется для совместной работы над документами Office, хранящимися в контейнере, за исключением задокументированных исключительных возможностей, таких как упоминания.

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

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

Его можно создать с помощью расширения SharePoint Embedded Visual Studio Code или Microsoft Graph.

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

Для Microsoft Graph создайте тип контейнера с классификацией выставления trial счетов.

К пробным типам контейнеров применяются следующие ограничения:

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

Создание стандартного типа контейнера с выставлением счетов владельца приложения

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

Каждый клиент может создать до 25 типов контейнеров в общей сложности. Один из них может быть типом контейнера бесплатной пробной версии; остальные являются стандартными (оплачиваемыми) типами контейнеров.

1. Создайте или определите владеющее Microsoft Entra ID приложение.
2. Создайте тип контейнера с классификацией выставления standard счетов.
3. Подключите профиль выставления счетов Azure с расширением SharePoint Embedded Visual Studio Code или потоком выставления счетов, управляемым администратором.
4. Запишите идентификатор типа контейнера.
5. Продолжайте регистрацию в используемом клиенте.

Примечание.

Если настройка выставления счетов завершается сбоем SubscriptionNotRegistered, подождите несколько минут и повторите попытку. Регистрация Microsoft.Syntex поставщика ресурсов может занять время.

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

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

1. Создайте или определите владеющее Microsoft Entra ID приложение.
2. Создайте тип контейнера с классификацией выставления directToCustomer счетов.
3. Зарегистрируйте тип контейнера в используемом клиенте.
4. Убедитесь, что администратор потребления клиента активирует службы с оплатой по мере использования.

Важно!

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

Администратор клиента активирует службы с оплатой по мере использования в Центр администрирования Microsoft 365. В разделе Настройка>выставления счетов и лицензий выберите Активировать службы с оплатой по мере использования.

В разделе Службы Syntex для выберите Приложения, а затем Выберите SharePoint Embedded , чтобы включить выставление счетов для приложения.

Настройка приложения Microsoft Entra ID

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

Запрос разрешений Microsoft Graph для доступа к SharePoint Embedded.

Запросите разрешение приложения Microsoft Graph FileStorageContainerTypeReg.Selected для регистрации типа контейнера в потребляющих клиентах.

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

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

Сведения о проверке подлинности см. в разделе Настройка проверки подлинности и авторизации.

Задание базовых свойств

Property	Рекомендации
Имя типа контейнера	Используйте устойчивое имя, которое сопоставляется с вашей рабочей нагрузкой.
Владение идентификатором приложения	Используйте регистрацию приложения, которому принадлежит этот тип.
URL-адрес перенаправления приложения	Используйте URL-адрес, по которому файлы из этого приложения должны перенаправляться.
Модель выставления счетов	Выберите пробную, стандартную или сквозную версию во время создания.

Предостережение

Идентификатор типа контейнера и идентификатор приложения-владельцев не удастся обновить позже.

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

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

Существуют следующие настройки:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

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

Важно!

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

Просмотр и обновление типов контейнеров

Используйте Microsoft Graph для вывода списка и обновления типов контейнеров.

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

Вам нужен владелец или участник доступ к подпискам на выставление счетов для изменения выставления счетов.

Управление типами контейнеров с помощью Microsoft Graph

Вы также можете управлять типами контейнеров с помощью fileStorageContainerType API Microsoft Graph.

Operation	API
Создание типа контейнера	Создание fileStorageContainerType
Вывод списка типов контейнеров	List fileStorageContainerType
Обновление типа контейнера	Обновление fileStorageContainerType
Удаление типа контейнера	Удаление fileStorageContainerType

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

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

Общие сведения о зависимости выставления счетов

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

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

Дополнительные сведения см. в разделах Счетчики SharePoint Embedded и Управление выставлением счетов SharePoint Embedded.

Ссылка на мультитенантное подключение

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

Используйте эту последовательность для каждого используемого клиента:

1. Создайте тип контейнера в арендаторе-владельце.
2. Попросите администратора клиента предоставить согласие администратора.
3. Регистрация разрешений приложения типа контейнера.
4. Настройте сквозное выставление счетов при оплате потребляющим клиентом.
5. Проверка создания контейнера и доступа к ней.

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

Регистрация разрешений в разделе Регистрация разрешений приложения.