コンテナーの種類とコンテナーについて

適用対象: Developer

この記事では、SharePoint Embedded の 2 つのコア ストレージ オブジェクトであるコンテナーの種類とコンテナーについて説明します。

作成と管理の完全なリファレンスについては、「 SharePoint 埋め込みコンテナーの種類」を参照してください。

オブジェクト モデル

SharePoint Embedded は、ファイルとドキュメントをコンテナーに格納し、コンテナーの種類ごとにグループ化します。 アプリケーションのコンテナを作成する前に、コンテナタイプを作成します。

オブジェクト 意味するもの 通常、誰が管理しているのか
コンテナーの種類 アプリとコンテナーのセット間の関係 (アクセス、動作、課金のアカウンタビリティなど)。 開発者またはコンテナーの種類の所有者。
コンテナー ファイルとフォルダーのストレージとセキュリティの境界。 Microsoft Graph を介してアプリケーションを実行し、ガバナンス運用の管理者が管理します。

コンテナーの種類の概念

コンテナーの種類は SharePoint Embedded リソースです。 それは定義します:

  • 所有しているアプリケーション。
  • アプリケーションとコンテナー間のアクセス権限。
  • 課金のアカウンタビリティ モデル。
  • その種類のコンテナーに適用される選択された動作。

各コンテナーの種類は、所有アプリケーションと呼ばれる 1 つの SharePoint Embedded アプリケーションと強く結び付けられています。 SharePoint Embedded では、所有するアプリケーションとコンテナーの種類の間に 1 対 1 の関係が必要です。 所有しているアプリケーション開発者は、コンテナー タイプの作成と管理を担当します。

コンテナーの種類 ID

コンテナーの種類は、 ContainerTypeID という名前の不変プロパティとして各コンテナーで表されます。 このプロパティは、SharePoint Embedded エコシステム全体で使用されます。 影響:

  • アクセス認証。
  • 試用版の探索。
  • 請求。
  • 構成可能な動作。

重要

コンテナーの種類は慎重に計画してください。 一部の作成選択肢 (試用版と運用版、標準課金とパススルー課金など) は、作成後に変換できません。 切り替えるには、コンテナーの種類を削除して再作成する必要があります。

Containers

コンテナーは SharePoint Embedded の基本的なストレージ ユニットであり、セキュリティとコンプライアンスの境界を定義します。 アプリケーションは、Microsoft Graph を使用して消費テナントにコンテナーを作成します。 コンテナーの作成には機密性の高いクライアント アプリケーションが必要なため、クライアント シークレットまたは証明書を保持するコンポーネントを計画してください。 詳細については、「 認証とアクセス許可を計画する」を参照してください。

Files、フォルダー、メタデータ、バージョン、ごみ箱のコンテンツはコンテナー内に格納され、現在の SharePoint Embedded の制限の対象となります。

制限については、「 制限と呼び出しパターンについて」を参照してください。

所有権

コンテナー タイプの所有権とコンテナーの常駐は異なります。 開発者テナントがコンテナーの種類を作成します。 消費テナントは、コンテナーの種類を使用し、コンテナーをホストします。

アプリケーションを通じて作成されたすべてのコンテナー コンテンツは、使用テナントの Microsoft 365 テナント境界内に保存されます。

テナント アーキテクチャについては、「 アプリとテナントのアーキテクチャについて」を参照してください。

アクセス認証

SharePoint Embedded アプリケーションは、その種類のコンテナーにアクセスするために、その種類のコンテナー タイプに関連付ける必要があります。 アソシエーション後、アプリケーションは、アプリケーション コンテナー タイプのアクセス許可に従って、その種類のコンテナーにアクセスできます。 所有アプリケーションには、既定で、結合されているコンテナーの種類のコンテナーに対するフル アクセス権限があります。 実際のアクセスは、アプリが委任アクセスを使用するか、アプリのみのアクセスを使用するかによっても異なります。

権限の計画については、「 認証と権限の計画」を参照してください。

試用版コンテナーの種類

試用版コンテナーの種類を使用して、Azure 課金プロファイルをリンクせずに SharePoint Embedded 開発を確認します。

評価版コンテナーの種類の場合:

  • 開発者テナントは、消費テナントと同じです。
  • 各開発者が一度にテナントに持つことができる試用版コンテナーの種類は 1 つだけです。
  • 試用版は最大 30 日間有効です。
  • アクティブなコンテナーとごみ箱内のコンテナーを含め、コンテナーの種類のコンテナーを最大 5 つまで作成できます。
  • 各コンテナーには最大 1 GB のストレージがあります。
  • コンテナーの種類は開発者テナントに制限されます。

試用版コンテナーの種類を運用環境に変換することはできません。

試用版コンテナーの種類を作成するために、開発者は SharePoint Embedded Visual Studio Code 拡張機能または Microsoft Graph コンテナーの種類 API を使用できます。

コンテナーの種類は、trial課金分類を使用して、Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes エンドポイントで作成されます。 この呼び出しには、 FileStorageContainerType.Manage.All 委任されたアクセス許可が必要です。アプリのみのアクセスはサポートされていません。 呼び出し元のユーザーは開発者テナントの非ゲスト メンバーである必要があり (管理者ロールは必要ありません)、新しいコンテナーの種類の所有者として自動的に割り当てられます。

Standardコンテナタイプ

標準コンテナーの種類は、評価版以外のシナリオで使用されます。

既定では、各テナントは一度に 25 種類のコンテナーを持つことができます。1 つは無料試用版のコンテナー型、残りは標準コンテナー型です。 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 Update fileStorageContainerType API を使用します。 管理設定については、「 PowerShell を使用したアプリの作成」を参照してください。

登録

消費するテナントでコンテナーを作成して操作するには、コンテナーの種類をそのテナントに登録する必要があります。

所有アプリケーションは登録 API を呼び出して、コンテナー タイプのアプリケーション アクセス許可を定義します。

詳細については、「 ファイル ストレージ コンテナーの種類のアプリケーションのアクセス許可を登録する」を参照してください。

計画チェックリスト

  • 試用版または標準版を選択します。
  • 運用環境の場合は、標準請求またはパススルー請求を選択します。
  • 所有しているアプリケーションを特定します。
  • コンテナーの種類の名前を確認します。
  • 使用しているテナントを確認します。
  • コンテナーの種類の登録を計画します。
  • アプリケーションのアクセス許可を計画します。
  • 必要なコンテナーの種類の設定を計画します。
  • コンテナーのライフサイクルと削除を計画します。

次の手順

認証と承認を計画する: 認証とアクセス許可を計画します。

  • Last updated on