了解容器类型和容器

适用于： 开发人员版

通过本文了解 SharePoint Embedded 中的两个核心存储对象：容器类型和容器。

有关完整的创建和管理参考，请参阅 SharePoint Embedded 容器类型。

对象模型

SharePoint Embedded 将文件和文档存储在容器中，这些文件和文档按容器类型分组。 先创建容器类型，然后才能为应用程序创建任何容器。

Object 它代表什么 通常由谁管理它
容器类型 应用与一组容器之间的关系，包括访问权限、行为和计费责任。 开发人员或容器类型所有者。
容器 文件和文件夹的存储和安全边界。 通过 Microsoft Graph 和管理员进行治理操作。

容器类型概念

容器类型是 SharePoint Embedded 资源。 它定义：

  • 拥有的应用程序。
  • 应用程序和容器之间的访问权限。
  • 计费责任模型。
  • 适用于该类型容器的选定行为。

每个容器类型都与一个 SharePoint Embedded 应用程序（称为拥有应用程序）紧密耦合。 SharePoint Embedded 要求拥有应用程序和容器类型之间存在 1：1 的关系。 拥有的应用程序开发人员负责创建和管理容器类型。

容器类型标识

容器类型在每个容器上表示为名为 ContainerTypeID的不可变属性。 该属性在整个 SharePoint Embedded 生态系统中使用。 它影响：

  • 访问授权。
  • 试用探索。
  • 计费。
  • 可配置的行为。

重要

仔细规划容器类型。 某些创建选项（例如试用与生产、标准与传递计费）在创建后无法转换。 若要切换，必须删除并重新创建容器类型。

容器

容器是 SharePoint Embedded 中的基本存储单元，它定义安全性和合规性边界。 应用程序使用 Microsoft Graph 在使用租户中创建容器。 容器创建需要机密客户端应用程序，因此请规划一个包含客户端密码或证书的组件。 有关详细信息，请参阅 计划身份验证和权限。

Files、文件夹、元数据、版本和回收站内容存储在容器中，并受当前 SharePoint Embedded 限制的约束。

有关限制，请参阅 了解限制和调用模式。

Ownership

容器类型所有权和容器驻留不同。 开发人员租户创建容器类型。 使用租户使用容器类型并托管容器。

通过该应用程序创建的所有容器内容都存储在使用租户的 Microsoft 365 租户边界内。

有关租户体系结构，请参阅 了解应用和租户体系结构。

访问授权

SharePoint Embedded 应用程序必须与容器类型相关联才能访问该类型的容器。 关联后，应用程序可以根据应用程序-容器类型权限访问该类型的容器。 默认情况下，拥有方应用程序对与其耦合的容器类型的容器具有完全访问权限。 实际访问权限还取决于应用是使用委派访问权限还是仅应用访问权限。

有关权限规划，请参阅 规划身份验证和权限。

试用容器类型

使用试用容器类型浏览 SharePoint Embedded 开发，而无需链接 Azure 计费配置文件。

对于试用容器类型：

  • 开发人员租户与使用租户相同。
  • 每个开发人员一次只能在其租户中有一个试用容器类型。
  • 试用版有效期最长为 30 天。
  • 最多可以创建 5 个容器类型的容器，包括活动容器和回收站中的容器。
  • 每个容器最多具有 1 GB 的存储空间。
  • 容器类型仅限于开发人员租户。

试用容器类型无法转换为生产容器类型。

若要创建试用容器类型，开发人员可以使用 SharePoint Embedded Visual Studio Code 扩展或 Microsoft Graph 容器类型 API。

容器类型是通过 Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes 终结点使用计费分类创建 trial 的。 此调用需要 FileStorageContainerType.Manage.All 委派的权限;不支持仅限应用的访问。 调用用户必须是开发人员租户的非来宾成员 (无需管理员角色) ，并且会自动分配为新容器类型的所有者。

Standard 容器类型

标准容器类型用于非试用方案。

默认情况下，每个租户一次可以有 25 个容器类型;一种可以是免费试用容器类型，其余是标准容器类型。 可以通过 Microsoft 支持人员或 SharePoint Embedded 载入联系人请求增加。

Standard 容器类型可计费，并且必须使用计费模型。

SharePoint Embedded 支持：

  • Standard计费 (standard 计费分类) 。
  • 传递计费 (directToCustomer 计费分类) 。

有关计费选择，请参阅 选择计费模式。

Standard 计费容器类型

使用标准计费时，基于消耗的费用将向拥有或开发应用程序的租户计费。

开发人员租户在创建标准容器类型后附加计费配置文件。

使用计费分类通过 standard Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes 终结点创建容器类型，然后附加 Azure 计费配置文件：

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "standard"
}

传递计费容器类型

使用传递计费时，费用将直接计费给消费租户。

开发人员使用计费分类创建容器类型 directToCustomer ，并且不在开发人员租户中附加计费配置文件。

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "directToCustomer"
}

注册后，使用租户中的全局管理员将在使用租户中设置计费。

管理员和开发人员交互

开发人员和管理员与不同层交互。

活动 容器类型 容器
创建应用的存储系列 是 否
配置拥有应用关系 是 否
配置计费责任 是 否
创建应用存储实例 否 是
存储文件和文件夹 否 是
应用特定于容器的治理 否 是
删除存储系列 是，删除容器后即可 否

容器类型配置

开发人员可以在创建后配置选定的容器类型设置。

可以配置以下容器类型设置：

  • ApplicationRedirectUrl
  • DiscoverabilityDisabled
  • SharingRestricted

使用 Microsoft Graph 更新 fileStorageContainerType API 进行受支持的容器类型更新。 有关管理设置，请参阅 使用 PowerShell 创建应用。

注册

若要在使用租户中创建容器并与之交互，必须在该租户中注册容器类型。

拥有的应用程序调用注册 API 来定义容器类型的应用程序权限。

有关完整详细信息，请参阅 注册文件存储容器类型应用程序权限。

计划清单

  • 选择试用版或标准版。
  • 为生产环境选择标准计费或直通计费。
  • 确定拥有的应用程序。
  • 确认容器类型名称。
  • 确认一个或多个使用租户。
  • 规划容器类型注册。
  • 规划应用程序权限。
  • 规划需要哪些容器类型设置。
  • 规划容器生命周期和删除。

后续步骤

规划身份验证和授权： 规划身份验证和权限。

  • Last updated on