コンテナーの種類の作成と構成

適用対象: Developer

1 回のクリックで SharePoint 埋め込み MCP サーバーをコーディング エージェントに追加します。

Visual Studio Code に追加する

プレリリース ビルドを使用していますか? サーバーを Visual Studio Code Insiders に追加します。

他の 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

Visual Studio Code 用の SharePoint Embedded 拡張機能をインストールして、コンテナーの種類の作成、所有するアプリと課金の構成、コンテナーの種類の登録、コンテナーの作成を行い、エディターのガイド付きビューからサンプル アプリを読み込みます。

Visual Studio Marketplace から拡張機能を入手する

アプリケーションの SharePoint 埋め込みコンテナーの種類を作成して、コンテナーを作成したり、ファイルを保存したりします。 コンテナーの種類は、アプリによって作成されたコンテナーのアクセス、課金の責任、選択された動作を定義します。

始めたばかりの場合は、「 クイック スタート: VS Code で最初のアプリを構築する」を完了してください。 次に、この記事を使用して、評価版、標準、およびパススルーの決定を行います。

最初にシングルテナント モデルとマルチテナント モデルのどちらかを決定するには、「 アプリ モデルの選択」を参照してください。

コンテナーの種類の関係を理解する

コンテナーの種類は、所有アプリケーションと呼ばれる 1 つの Microsoft Entra ID アプリケーションと強く結び付けられています。

SharePoint Embedded では、1 つの所有アプリケーションと 1 つのコンテナーの種類の間に 1 対 1 の関係が必要です。

コンテナーの種類 ID は、不変プロパティとして各コンテナーに格納されます。

SharePoint Embedded では、アクセスの承認、試用版の探索、課金、および構成可能な動作に ID を使用します。

注:

Microsoft Graph API (Create fileStorageContainerType) は委任のみであり、ゲスト所有テナント以外のユーザーが呼び出すことができます。 呼び出し元は管理者ロールを必要とせず、新しいコンテナーの種類の所有者として自動的に割り当てられます。

評価版または運用環境を選択する

コンテナーの種類の目的を作成するときに選択します。

トライアル コンテナーの種類を後で運用環境に変換することはできません。

コンテナーの種類を標準請求からパススルー請求に後で変更することはできません。

ユース ケース コンテナーの種類
ローカルの概念実証 試用版コンテナーの種類
デベロッパー テナントが支払う 標準課金のコンテナー タイプ
テナント料金の消費 パススルー課金を使用するコンテナーの種類

重要

間違った目的または課金モデルを選択した場合は、コンテナーの種類を再作成する必要があります。

前提条件

コンテナーの種類を作成する前に、次のことを確認してください:

  • SharePoint が利用できる Microsoft 365 テナント。
  • 所有アプリの Microsoft Entra ID アプリ登録。
  • 所有テナントのゲスト以外のメンバー アカウント。
  • Standard 課金の場合、Azure サブスクリプションとリソース グループ。
  • 管理者以外として既存の標準コンテナー タイプの課金を管理するには、 そのコンテナー タイプの所有者になります。 SharePoint Embedded 管理者とグローバル管理者は、開発者テナント内の任意の標準請求コンテナーの種類を管理できます。
  • 標準課金設定の場合、Azure サブスクリプションへの所有者または共同作成者のアクセス。

注:

  • Microsoft Graph を使用してコンテナーの種類を作成する場合に必要なのは、 FileStorageContainerType.Manage.All 委任されたアクセス許可のみです。 所有テナントのゲスト以外のユーザーは誰でも作成でき、 そのコンテナーの種類の所有者として自動的に割り当てられます。 テナント全体の管理操作については、「 PowerShell を使用したアプリの作成」を参照してください。

  • コンテナーに認証するユーザーは、メンバーまたはゲストとして Microsoft Entra ID に存在する必要があります。 コンテナーに保存されている Office ドキュメントで共同作業を行うために Office ライセンスは必要ありません。ただし、メンションなどの例外的なエクスペリエンスが文書化されている場合を除きます。

試用版コンテナーの種類の作成

評価には試用版コンテナーの種類を使用します。

SharePoint 埋め込み Visual Studio Code 拡張機能または Microsoft Graph を使用して作成できます。

Visual Studio Code のパスは、最初のアプリとしては最速です。 「 クイック スタート: VS Code で最初のアプリをビルドする」を参照してください。

Microsoft Graph の場合は、 trial 課金分類のコンテナーの種類を作成します。

評価版コンテナーの種類には、次の制限が適用されます。

  • テナントは、このコンテナーの種類のコンテナーを最大 5 つ持つことができます。 これには、アクティブなコンテナーとごみ箱内のコンテナーが含まれます。
  • 各コンテナーには最大 1 GB のストレージ容量があります。
  • コンテナーの種類は 30 日後に有効期限が切れ、そのコンテナーの種類の既存のコンテナーへのアクセスは削除されます。
  • 開発者は、評価版ステータスの既存のコンテナー タイプのすべてのコンテナーを完全に削除して、評価版用の新しいコンテナー タイプを作成する必要があります。 これには、削除されたコンテナー コレクション内のコンテナーも含まれます。
  • コンテナーの種類は、開発者テナントで動作するように制限されます。 他の消費テナントにはデプロイできません。

標準請求でコンテナーの種類を作成する

開発者テナントが従量課金を支払う場合は、標準課金を使用します。

各テナントは、合計で最大 25 種類のコンテナーを作成できます。 そのうちの 1 つは、無料試用版のコンテナーの種類です。残りは標準 (請求) コンテナーの種類です。

  1. 所有している Microsoft Entra ID アプリケーションを作成または識別します。
  2. standard請求分類を使用してコンテナーの種類を作成します。
  3. コンテナーの種類の課金を管理します。 SharePoint Embedded Visual Studio Code 拡張機能と SharePoint Embedded Model Context Protocol (MCP) サーバー により、標準請求コンテナーの種類の課金管理が有効になります。 SharePoint Embedded 管理者とグローバル管理者は、 PowerShell を使用して課金を管理することもできます。
  4. コンテナーの種類の ID を記録します。
  5. 使用しているテナントでの登録を続行します。

注:

SubscriptionNotRegisteredで請求の設定が失敗する場合は、数分待ってから再試行してください。 Microsoft.Syntex リソース プロバイダーの登録には時間がかかる場合があります。

パススルー請求コンテナーの種類の作成

使用テナントが消費に対して支払う場合は、パススルー請求を使用します。

  1. 所有している Microsoft Entra ID アプリケーションを作成または識別します。
  2. directToCustomer請求分類を使用してコンテナーの種類を作成します。
  3. 使用するテナントにコンテナーの種類を登録します。
  4. 消費テナントの課金管理者またはグローバル管理者に、従量課金制サービスをアクティブ化してもらいます。

重要

消費テナントは、パススルー アプリケーションを正常に使用する前に、課金設定を完了する必要があります。

消費テナントの課金管理者またはグローバル管理者が、Microsoft 365 管理センターで従量課金制サービスをアクティブ化します。 [ セットアップ>課金とライセンス] で、[ 従量課金制サービスをアクティブ化する] を選択します。

[従量課金制サービスのアクティブ化] オプションを含む Microsoft 365 管理センターの課金とライセンス セクション。

[ Syntex services for] で、[ アプリ]、[ SharePoint Embedded ] の順に選択して、アプリの課金を有効にします。

Microsoft 365 管理センターの [アプリ] パネルで、SharePoint Embedded を選択して従量課金制の課金をアクティブ化します。

所有する Microsoft Entra ID アプリを構成する

1 つのコンテナーの種類だけを所有できるようにアプリを構成します。

SharePoint Embedded アクセス用の Microsoft Graph のアクセス許可を要求します。

消費テナント FileStorageContainerTypeReg.Selected コンテナーの種類を登録するための Microsoft Graph アプリケーションのアクセス許可を要求します。

開発クライアントと運用クライアントに一致するリダイレクト URI を使用します。

委任されたフローまたはアプリのみのフローに適した資格情報を使用します。

認証の詳細については、「 認証と承認の構成」を参照してください。

基本プロパティを設定する

プロパティ ガイダンス
コンテナーの種類名 ワークロードに対応する永続的な名前を使用してください。
所有しているアプリケーション ID この種類を所有するアプリの登録を使用します。
アプリケーション リダイレクト URL このアプリのファイルをリダイレクトする URL を使用します。
課金モデル 作成時に試用版、標準請求、またはパススルー請求を選択します。

注意

コンテナーの種類 ID と所有アプリケーション ID は後で更新できません。

コンテナーの種類の動作を構成する

開発者は、作成後に選択した動作を構成できます。

使用可能な設定は次のとおりです。

  • urlTemplate
  • isDiscoverabilityEnabled
  • isSharingRestricted

サポートされているコンテナーの種類の更新には、Microsoft Graph Update fileStorageContainerType API を使用します。 テナント全体の管理設定については、「 PowerShell を使用してアプリを作成する」を参照してください。

重要

コンテナーの種類の設定を更新した場合、使用するすべてのテナントにレプリケートされるまでに最大 24 時間 かかる場合があります。 消費するテナントが設定のオーバーライドを適用した場合、それらのオーバーライドはそのまま残ります。 一部の設定は新しいコンテンツにのみ適用され、既存のコンテンツには適用されません。

コンテナー タイプの表示と更新

コンテナーの種類の一覧表示と更新を行うには、Microsoft Graph を使用します。

管理者以外のコンテナー タイプ所有者は、所有するコンテナー タイプを更新できます。 また、標準の請求プロファイルを作成して管理することもできます。

所有者には、課金変更のために Azure サブスクリプションへの所有者または共同作成者のアクセス権が必要です。

Microsoft Graph を使用してコンテナーの種類を管理する

fileStorageContainerType Microsoft Graph API を使用してコンテナーの種類を管理することもできます。

操作 API
コンテナーの種類の作成 ファイルの作成StorageContainerType
コンテナーの種類を一覧表示する fileStorageContainerType の一覧
コンテナーの種類を更新する fileStorageContainerType の更新
コンテナーの種類を削除する delete fileStorageContainerType

リストの結果は、所有権でフィルター処理されます。 管理者以外のユーザーには、アクセス許可を付与されているコンテナーの種類のみが表示されます。一方、SharePoint Embedded 管理者とグローバル管理者には、テナント内のすべてのコンテナーの種類が表示されます。 構成できる設定については、「 fileStorageContainerTypeSettings 」を参照してください。

削除できるのは、試用版のコンテナーの種類のみです。標準コンテナーの種類の削除はまだサポートされていません。 コンテナーの種類を削除する前に、削除されたコンテナー コレクション内のコンテナーを含め、その種類のすべてのコンテナーを削除します。

課金の依存関係について

標準課金の場合、開発者テナントは Azure サブスクリプションとリソース グループをアタッチします。

パススルー請求の場合、消費テナントは従量課金制サービスをアクティブ化します。

詳細については、「 SharePoint Embedded メーター」 と「 SharePoint Embedded 課金管理」を参照してください。

マルチテナント アプリには通常、所有テナントと 1 つ以上の消費テナントがあります。

使用するテナントごとに、次のシーケンスを使用します。

  1. 所有テナントにコンテナーの種類を作成します。
  2. 使用しているテナント管理者に管理者の同意を付与するように依頼します。
  3. コンテナーの種類のアプリケーションのアクセス許可を登録します。
  4. 消費テナントが支払うときのパススルー請求を構成します。
  5. コンテナーの作成とアクセスを検証します。

次の手順

[ アプリケーションのアクセス許可の登録] でアクセス許可を登録します。

  • 最終更新: