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

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

Добавьте сервер SharePoint Embedded MCP в агент кодирования одним щелчком мыши.

Добавить в Visual Studio Code

Используете предварительную сборку? Добавьте сервер в список участников программы предварительной оценки Visual Studio Code.

Для других клиентов MCP зарегистрируйте сервер с той же npx командой:

# Claude Code
claude mcp add spe -- npx -y @microsoft/spe-mcp start

# OpenAI Codex CLI
codex mcp add spe -- npx -y @microsoft/spe-mcp start

Установите расширение SharePoint Embedded для Visual Studio Code, чтобы создать тип контейнера, настроить приложение-владелец и выставление счетов, зарегистрировать тип контейнера, создать контейнеры и загрузить пример приложения из управляемого представления в редакторе:

Получите расширение из Visual Studio Marketplace

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

Важно!

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

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

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

  • Клиент Microsoft 365 с доступным приложением SharePoint.
  • Регистрация приложения Microsoft Entra ID для приложения-владельца.
  • Учетная запись участника, не являющаяся гостевой в клиенте-владельце.
  • Для стандартного выставления счетов подписка Azure и группа ресурсов.
  • Чтобы управлять выставлением счетов для существующего стандартного типа контейнера как пользователь, не являющийся администратором, необходимо быть владельцем этого типа контейнера. Администраторы SharePoint Embedded и глобальные администраторы могут управлять любым типом контейнера со стандартным счетом в клиенте разработчика.
  • Для стандартной настройки выставления счетов предоставляется доступ владельца или участника к подписке 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. Управление выставлением счетов для типа контейнера. Расширение SharePoint Embedded Visual Studio Code и сервер SharePoint Embedded Model Context Protocol (MCP) обеспечивают управление выставлением счетов для контейнеров со стандартным счетом. Администраторы SharePoint Embedded и глобальные администраторы также могут использовать PowerShell для управления выставлением счетов.
  4. Запишите идентификатор типа контейнера.
  5. Перейдите к регистрации в клиенте-потребителе.

Примечание.

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

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

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

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

Важно!

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

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

Центр администрирования Microsoft 365 Раздел

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

Панель приложений Центра администрирования Microsoft 365 с выбранным SharePoint Embedded для активации выставления счетов с оплатой по мере использования.

Настройка приложения Microsoft Entra ID, владеющего

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

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

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

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

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

Дополнительные сведения об аутентификации см. в статье Настройка проверки подлинности и авторизации.

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

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

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

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

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

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

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

  • urlTemplate
  • isDiscoverabilityEnabled
  • isSharingRestricted

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

Важно!

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

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

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

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

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

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

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

Operation API
Создание типа контейнера Create fileStorageContainerType
Перечисление типов контейнеров List fileStorageContainerType
Обновление типа контейнера Обновление fileStorageContainerType
Удаление типа контейнера Delete fileStorageContainerType

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

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

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

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

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

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

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

Используйте следующую последовательность для каждого клиента-потребителя:

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

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

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

  • Последнее обновление: