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

適用対象: 開発者

アプリケーション用の SharePoint Embedded コンテナーの種類を作成して、コンテナーを作成するか、ファイルを格納します。 コンテナーの種類は、アプリによって作成されたコンテナーのアクセス、課金の説明責任、および選択した動作を定義します。

作業を開始したばかりの場合は、「 クイック スタート: VS Code を使用して最初のアプリをビルドする」を完了します。 次に、試用版、標準、パススルーの決定にこの記事を使用します。

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

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

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

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

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

ID は、アクセス許可、試用版の探索、課金、構成可能な動作に使用されます。

試用版または運用を選択する

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

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

標準請求の種類を後でパススルー請求に変換することはできません。

前提条件

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

• SharePoint を使用できる Microsoft 365 テナント。
• 所有しているアプリのMicrosoft Entra IDアプリ登録。
• 所有テナント内のゲスト以外のメンバー アカウント。
• 標準請求の場合は、Azureサブスクリプションとリソース グループ。
• Azure サブスクリプションに対する標準の課金設定、所有者または共同作成者のアクセス許可の場合。

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

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

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

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

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

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

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

アプリ所有者の課金を使用して標準コンテナーの種類を作成する

開発者またはアプリ所有者のテナントが従量課金を行う場合は、標準課金を使用します。

各テナントには、一度に最大 25 種類の標準コンテナーを使用できます。

1. 所有するMicrosoft Entra ID アプリケーションを作成または識別します。
2. standard課金分類を使用してコンテナーの種類を作成します。
3. Azure課金プロファイルを SharePoint Embedded Visual Studio Code 拡張機能または管理者が管理する課金フローにアタッチします。
4. コンテナーの種類 ID を記録します。
5. 引き続き、使用しているテナントに登録します。

パススルー課金コンテナーの種類を作成する

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

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

使用しているテナント管理者は、Microsoft 365 管理センターで従量課金制サービスをアクティブにします。 [セットアップ>課金とライセンス] で、[従量課金制サービスのアクティブ化] を選択します。

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

所有Entraアプリを構成する

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

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

テナントを使用する場合 FileStorageContainerTypeReg.Selected コンテナーの種類の登録に対するアプリケーションのアクセス許可を Microsoft Graph に要求します。

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

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

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

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

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

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

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

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

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

コンテナーの種類の表示と更新

Microsoft Graph を使用して、コンテナーの種類を一覧表示および更新します。

管理者以外のコンテナーの種類の所有者は、所有するコンテナーの種類を更新できます。

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

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

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

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

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

課金の依存関係を理解する

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

パススルー課金では、従量課金制テナントによって従量課金制サービスがアクティブ化されます。

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

マルチテナント オンボードへのリンク

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

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

1. 所有テナントにコンテナーの種類を作成します。
2. 使用しているテナント管理者に管理者の同意を求めます。
3. コンテナーの種類のアプリケーションのアクセス許可を登録します。
4. 使用しているテナントの支払い時にパススルー課金を構成します。
5. コンテナーの作成とアクセスを検証します。

次の手順

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