创建和配置容器类型

适用于： 开发 人员

为应用程序创建 SharePoint Embedded 容器类型以创建容器或存储文件。 容器类型为应用创建的容器定义访问权限、计费责任和所选行为。

如果刚开始，请完成 快速入门：使用 VS Code 生成第一个应用。 然后，使用本文进行试用、标准和传递决策。

若要首先决定单租户模型和多租户模型，请参阅 选择应用模型。

了解容器类型关系

容器类型与一个Microsoft Entra ID应用程序（称为拥有应用程序）紧密耦合。

SharePoint Embedded 需要一个拥有的应用程序和一个容器类型之间的一对一关系。

容器类型 ID 作为不可变属性存储在每个容器上。

该 ID 用于访问授权、试用浏览、计费和可配置行为。

注意

Microsoft图形 API（Create fileStorageContainerType）仅委派，可由任何非来宾拥有租户用户调用。 调用方不需要管理员角色，会自动分配为新容器类型的所有者。

选择试用版或生产

在创建容器时选择容器类型用途。

以后无法将试用容器类型转换为生产环境。

以后无法将标准计费类型转换为直通计费。

用例 容器类型
本地概念证明 试用容器类型
应用所有者付费 使用计费配置文件Standard容器类型
客户租户付款 使用直通计费Standard容器类型

重要

如果选择了错误的用途或计费模型，则必须重新创建容器类型。

先决条件

在创建容器类型之前，请确保：

  • 具有 SharePoint 可用Microsoft 365 租户。
  • 拥有应用的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 GB 的存储空间。
  • 容器类型将在 30 天后过期，然后删除对该容器类型的任何现有容器的访问权限。
  • 开发人员必须永久删除试用状态中现有容器类型的所有容器，才能创建新的容器类型以供试用。 这包括已删除容器集合中的容器。
  • 容器类型仅限于在开发人员租户中工作。 它不能部署在其他使用租户中。

使用应用所有者计费创建标准容器类型

当开发人员或应用所有者租户支付消耗费用时，请使用标准计费。

每个租户一次最多可以有 25 个标准容器类型。

  1. 创建或标识拥有Microsoft Entra ID应用程序。
  2. 使用 standard 计费分类创建容器类型。
  3. 使用 SharePoint Embedded Visual Studio Code扩展或管理员管理的计费流附加Azure计费配置文件。
  4. 记录容器类型 ID。
  5. 继续在使用租户中注册。

注意

如果计费设置失败，请 SubscriptionNotRegistered等待几分钟，然后重试。 资源 Microsoft.Syntex 提供程序注册可能需要一段时间。

创建直通计费容器类型

当使用租户支付消耗费用时，请使用直通计费。

  1. 创建或标识拥有Microsoft Entra ID应用程序。
  2. 使用 directToCustomer 计费分类创建容器类型。
  3. 在使用的租户中注册容器类型。
  4. 让使用租户管理员激活即用即付服务。

重要

使用租户必须完成计费设置，然后才能成功使用直通应用程序。

使用租户管理员在Microsoft 365 管理中心激活即用即付服务。 在 “设置>计费和许可证”中，选择 “激活即用即付服务”。

使用“激活即用即付服务”选项Microsoft 365 管理中心计费和许可证部分。

在 “Syntex 服务”下，选择“ 应用”，然后选择“ SharePoint Embedded ”，为应用启用计费。

Microsoft 365 管理中心应用程序面板，其中已选择 SharePoint Embedded 以激活即用即付计费。

配置拥有Entra应用

配置应用，使其只能拥有一种容器类型。

请求 Microsoft Graph 权限以访问 SharePoint Embedded。

针对使用租户的容器类型注册请求Microsoft Graph FileStorageContainerTypeReg.Selected 应用程序权限。

使用与开发和生产客户端匹配的重定向 URI。

使用适用于委派流或仅限应用的流的凭据。

有关身份验证的详细信息，请参阅 配置身份验证和授权。

设置基本属性

属性 指南
容器类型名称 使用映射到工作负荷的持久名称。
拥有应用程序 ID 使用拥有此类型的应用注册。
应用程序重定向 URL 使用此应用中的文件应重定向的 URL。
计费模型 在创建时选择试用、标准或直通。

警告

容器类型 ID 和拥有应用程序 ID 以后无法更新。

配置容器类型行为

开发人员可以在创建后配置所选行为。

可用的设置包括：

  • ApplicationRedirectUrl
  • DiscoverabilityDisabled
  • SharingRestricted

使用 Microsoft Graph 更新文件StorageContainerType API 进行支持的容器类型更新。 有关租户范围的管理设置，请参阅 使用 PowerShell 创建应用。

重要

更新容器类型的设置最多可能需要 24 小时 才能复制到所有使用租户。 如果已应用的使用租户设置替代，则这些替代将保留到位。 某些设置仅适用于新内容，不适用于现有内容。

查看和更新容器类型

使用 Microsoft Graph 列出和更新容器类型。

非管理员容器类型所有者可以更新其拥有的容器类型。

需要所有者或参与者对计费订阅的访问权限才能更改计费。

使用 Microsoft Graph 管理容器类型

还可以使用 fileStorageContainerType Microsoft Graph API 管理容器类型。

操作 API
创建容器类型 创建 fileStorageContainerType
列出容器类型 列出 fileStorageContainerType
更新容器类型 更新 fileStorageContainerType
删除容器类型 删除 fileStorageContainerType

列表结果按所有权筛选。 非管理员用户仅看到已向其授予权限的容器类型，而 SharePoint Embedded 管理员和全局管理员将看到租户中的每个容器类型。 有关可配置的设置，请参阅 fileStorageContainerTypeSettings。

只能删除试用容器类型;尚不支持删除标准容器类型。 删除容器类型之前，请删除该类型的每个容器，包括已删除容器集合中的容器。

了解计费依赖项

对于应用所有者计费，开发人员租户附加Azure订阅和资源组。

对于直通计费，使用租户会激活即用即付服务。

有关详细信息，请参阅 SharePoint Embedded 计量 和 SharePoint Embedded 计费管理。

多租户应用通常拥有一个租户和一个或多个使用租户。

对每个使用租户使用此序列：

  1. 在拥有租户中创建容器类型。
  2. 请求使用租户管理员授予管理员同意。
  3. 注册容器类型应用程序权限。
  4. 在使用租户付款时配置直通计费。
  5. 验证容器创建和访问。

后续步骤

在“注册应用程序权限”中 注册权限。

  • Last updated on