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

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

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

Тип контейнера представлен на каждом экземпляре контейнера как неизменяемое свойство (ContainerTypeID) и используется во всей экосистеме SharePoint Embedded, в том числе:

• Авторизация доступа. Приложение SharePoint Embedded должно быть связано с типом контейнера, чтобы получить доступ к экземплярам контейнеров этого типа. После связывания приложение имеет доступ ко всем экземплярам контейнеров этого типа. Фактические права доступа определяются параметром разрешения application-ContainerTypeID. Владеющее приложение по умолчанию имеет полный доступ ко всем экземплярам контейнеров типа, с которым он тесно связан. Узнайте больше об авторизации SharePoint Embedded.
• Простой просмотр. Типы контейнеров можно создавать в пробных целях, что позволяет разработчикам бесплатно изучать разработку приложений SharePoint Embedded и оценивать его функции.
• Выставление счетов. Типы контейнеров для несудебных целей оплачиваются и должны создаваться с Azure подпиской. Использование контейнеров измеряется и взимается плата. Узнайте больше о отслеживании использования и интерфейсе выставления счетов SharePoint Embedded.
• Настраиваемое поведение. Тип контейнера определяет выбранное поведение для всех экземпляров контейнеров этого типа. Узнайте больше о настройке конфигурации типа контейнера.

Примечание.

1. Необходимо указать назначение типа контейнера, создаваемого во время создания. Тип контейнера, заданный для пробных целей, не может быть преобразован в рабочую среду; или наоборот.
2. Standard и типы контейнеров сквозной передачи нельзя преобразовать после создания. Если вы хотите преобразовать стандартный тип контейнера в сквозное выставление счетов или наоборот, необходимо удалить и повторно создать тип контейнера.

Требования к клиенту

• В клиенте Microsoft 365 требуется активный экземпляр SharePoint.
• Пользователи, которые проходят проверку подлинности в типах контейнеров и контейнерах SharePoint Embedded, должны находиться в Microsoft Entra ID (участники и гости)
• Для управления типами контейнеров необходимо настроить регистрацию приложения Microsoft Entra ID. Дополнительные сведения см. в статье Проверка подлинности и авторизация SharePoint Embedded.

Примечание.

Лицензия Office не требуется для совместной работы с документами Microsoft Office, хранящимися в контейнере.

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

SharePoint Embedded имеет два разных типа контейнеров, которые можно создать.

1. Тип контейнера пробной версии. Использует классификацию выставления trial счетов.
2. Standard тип контейнера. Использует классификацию выставления standard счетов или directToCustomer .

Чтобы создать тип контейнера, приложение Microsoft Entra ID должно иметь FileStorageContainerType.Manage.All разрешение приложения на принадлежащий клиенту. Приложению Microsoft Entra ID необходимо вызвать конечную точку Create fileStorageContainerType от имени администратора SharePoint Embedded:

POST https://graph.microsoft.com/beta/storage/fileStorage/containerTypes
Content-Type: application/json

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{ApplicationId}",
  "billingClassification": "{BillingClassification}",
  "settings": {
    ...
  }
}

Примечание.

Необходимо заменить:

• {ContainerTypeName} с понятным именем для приложения SharePoint Embedded.
• {ApplicationId} с идентификатором правильно настроенного идентификатора приложения.
• {BillingClassification}с , trialstandardили directToCustomer. Продолжайте читать, чтобы понять, что каждый из них означает.

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

Тип контейнера пробной версии

Тип контейнера можно создать для пробной версии или разработки и не связан ни с каким Azure профилем выставления счетов. Пробные типы контейнеров позволяют разработчикам бесплатно изучать разработку приложений SharePoint Embedded и оценивать его функции. Для пробных типов контейнеров клиент разработчика является таким же, как и используемый клиент. Каждый разработчик может одновременно иметь только один тип контейнера с trial классификацией выставления счетов в клиенте. Тип пробного контейнера действителен в течение 30 дней, но его можно удалить в любое время в течение этого периода.

Тип контейнера пробной версии можно легко настроить с помощью расширения SharePoint Embedded Visual Studio Code.

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

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

Standard типы контейнеров (несудебные)

Стандартный тип контейнера можно использовать в рабочих средах. Каждый клиент может иметь 25 типов контейнеров одновременно. Standard типы контейнеров имеют не те же ограничения, что и пробные типы контейнеров, но они по-прежнему имеют ограничения. Дополнительные сведения см. в статье Ограничения sharePoint Embedded.

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

Профиль выставления счетов

SharePoint Embedded — это основанная на потреблении система с оплатой по мере использования (PAYG), означающая, что вы платите только за то, что используете. SharePoint Embedded предоставляет две модели выставления счетов, которые клиент, разрабатывающий приложение SharePoint Embedded, может выбрать для соответствующих типов контейнеров, адаптируя его к уникальным бизнес-требованиям. Две модели выставления счетов — это Standard и сквозное выставление счетов.

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

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

Существуют ограничения на количество типов контейнеров, которые могут быть у каждого клиента. Дополнительные сведения см. в статье Ограничения sharePoint Embedded.

Роли и разрешения

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

Подписка на Azure

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

• Создание подписки на Azure в клиенте
• Создание группы ресурсов, присоединенной к подписке Azure

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

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

Профиль выставления счетов для типа контейнера создается с помощью командная консоль SharePoint Online:

1. Скачайте и установите последнюю версию командная консоль SharePoint Online
2. Откройте командная консоль SharePoint Online на начальном экране, введите sharepoint и выберите командная консоль SharePoint Online.
3. Подключитесь к службе SPO с помощью Connect-SPOService командлета, предоставив учетные данные администратора, связанные с клиентом. Дополнительные сведения см . в статье Использование Connect-SPOService. . Чтобы создать стандартный профиль выставления счетов для типа контейнера, используйте следующий командлет:

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Примечание.

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

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

Приложение с одним владельцем может одновременно владеть только одним типом контейнера.

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

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

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

Set-SPOContainerType -ContainerTypeId <ContainerTypeId> [-AzureSubscriptionId <AzureSubscriptionId>] [-ResourceGroup <ResourceGroup>]

Примечание.

Настройка выставления счетов для стандартных типов контейнеров выполняется с помощью командная консоль SharePoint Online. В будущем эта операция будет доступна как операция Microsoft Graph.

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

При сквозном выставлении счетов плата на основе потребления выставляется непосредственно клиенту, зарегистрированного для использования приложения SharePoint Embedded (потребляющего клиента). Администраторам в клиенте разработчика не нужно настраивать профиль выставления счетов Azure при создании сквозного типа контейнера SharePoint Embedded.

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

После регистрации типа контейнера в потребляемом клиенте администратору потребляющего клиента (администратору SharePoint или глобальному администратору) необходимо настроить профиль выставления счетов в используемом клиенте для использования приложения SharePoint Embedded.

Настройка профиля выставления счетов в потребляемом клиенте

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

   

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

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

   

   Примечание.

   Подписка, настроенная в службах Syntex, будет отражать расходы на Azure портале выставления счетов.

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

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

Важно!

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

Сведения обо всех параметрах, поддерживаемых типами контейнеров, см. в разделе Тип ресурса fileStorageContainerTypeSettings.

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

Разработчик Администратор может просматривать все типы контейнеров SharePoint Embedded, созданные в клиенте, с помощью конечной точки List fileStorageContainerType.

Регистрация типов контейнеров

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

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

Разработчик Администратор может удалять только пробные типы контейнеров в своем клиенте. Удаление стандартных типов контейнеров пока не поддерживается. Чтобы удалить тип контейнера, сначала необходимо удалить все контейнеры этого типа, в том числе из коллекции удаленных контейнеров. Сведения об удалении контейнеров см. в статье Использование Администратор клиента. После удаления всех контейнеров администраторы разработчиков могут удалить тип контейнера с помощью конечной точки Delete fileStorageContainerType.