SharePoint Embedded コンテナーの種類

コンテナーの種類は SharePoint Embedded リソースであり、SharePoint Embedded アプリケーションとコンテナーのセットとの間の関係、アクセス権限、課金アビリティを定義します。 また、コンテナーの種類は、コンテナーのセットに対する動作を定義します。

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

コンテナーの種類は、各コンテナー インスタンスで不変プロパティ (ContainerTypeID) として表され、SharePoint Embedded エコシステム全体で次のように使用されます。

• アクセス許可: SharePoint Embedded アプリケーションをコンテナーの種類に関連付けて、その種類のコンテナー インスタンスにアクセスする必要があります。 関連付けられると、アプリケーションはその型のすべてのコンテナー インスタンスにアクセスできます。 実際のアクセス権は、application-ContainerTypeID アクセス許可設定によって決まります。 既定では、所有するアプリケーションには、厳密に結合されているコンテナーの種類のすべてのコンテナー インスタンスに対するフル アクセス権があります。 SharePoint Embedded Authorization の詳細については、こちらをご覧ください。
• 簡単な探索: コンテナーの種類は試用目的で作成できるため、開発者は SharePoint Embedded アプリケーション開発を探索し、その機能を無料で評価できます。
• 課金: 不利益を目的としたコンテナーの種類は課金対象であり、Azure サブスクリプションで作成する必要があります。 コンテナーの使用状況は従量制課金されます。 測定と SharePoint Embedded 課金エクスペリエンスの詳細について説明します。
• 構成可能な動作: コンテナー型は、その型のすべてのコンテナー インスタンスに対して選択した動作を定義します。 コンテナーの種類の構成の設定について詳しくは、こちらをご覧ください。

注:

1. 作成時に作成するコンテナーの種類の目的を指定する必要があります。 試用版用に設定されたコンテナーの種類は、運用環境用に変換できません。またはその逆です。
2. Standardとパススルー コンテナーの種類は、一度作成すると変換できません。 標準のコンテナーの種類をパススルー課金に変換する場合、またはその逆を変換する場合は、コンテナーの種類を削除して再作成する必要があります。

テナントの要件

• Microsoft 365 テナントでは、SharePoint のアクティブ なインスタンスが必要です。
• SharePoint Embedded コンテナーの種類とコンテナーに対して認証を行うユーザーは、Microsoft Entra IDに存在する必要があります (メンバーとゲスト)
• Microsoft Entra ID アプリの登録は、コンテナーの種類の管理用に構成する必要があります。 詳細については、「 SharePoint Embedded の認証と承認」を参照してください。

注:

コンテナーに格納されている Microsoft Office ドキュメントで共同作業するには、Office ライセンスは必要ありません。

コンテナーの種類の作成

SharePoint Embedded には、作成できる 2 つの異なるコンテナーの種類があります。

1. 試用版コンテナーの種類。 trial課金分類を使用します。
2. コンテナーの種類Standard。 standardまたはdirectToCustomer課金分類を使用します。

コンテナーの種類を作成するには、Microsoft Entra ID アプリケーションに、所有しているテナントに対するFileStorageContainerType.Manage.All アプリケーションのアクセス許可が必要です。 Microsoft Entra ID アプリケーションでは、SharePoint Embedded Administrator の代わりに create fileStorageContainerType エンドポイントを呼び出す必要があります。

POST https://graph.microsoft.com/beta/storage/fileStorage/containerTypes
Content-Type: application/json

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{ApplicationId}",
  "billingClassification": "{BillingClassification}",
  "settings": {
    ...
  }
}

注:

を置き換える必要があります。

• {ContainerTypeName} SharePoint Embedded アプリケーションのわかりやすい名前を使用します。
• {ApplicationId} 正しく構成されたアプリケーション ID の ID を使用します。
• {BillingClassification} trial、standard、またはdirectToCustomer。 読み続けて、それぞれの意味を理解してください。

さらに、settings フィールドを使用して、作成時にコンテナーの種類を構成することもできます。

試用版コンテナーの種類

コンテナーの種類は、試用版/開発目的で作成でき、Azure課金プロファイルにはリンクされません。 試用版コンテナーの種類を使用すると、開発者は SharePoint Embedded アプリケーション開発を探索し、その機能を無料で評価できます。 試用版コンテナーの種類の場合、開発者テナントは、使用しているテナントと同じです。 各開発者は、テナントで一度に trial 課金分類を持つコンテナーの種類を 1 つだけ持つことができます。 試用版コンテナーの種類は最大 30 日間有効ですが、この期間内はいつでも削除できます。

SharePoint Embedded Visual Studio Code 拡張機能を使用して、試用版コンテナーの種類を簡単に設定できます。

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

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

Standard コンテナーの種類 (非トリアル)

標準的なコンテナーの種類は、運用環境で使用できます。 各テナントには、一度に 25 種類のコンテナーを使用できます。 Standardコンテナーの種類には、試用版コンテナーの種類と同じ制限はありませんが、引き続き制限があります。 詳細については、「 SharePoint 埋め込み制限」を参照してください。

サポートされている従量課金制メーターの詳細については、 SharePoint Embedded のメーター に関する記事を参照してください。

課金プロファイル

SharePoint Embedded は、従量課金制の従量課金制 (PAYG) オファリングです。これは、使用した分だけ支払うことを意味します。 SharePoint Embedded には、SharePoint Embedded アプリケーションを開発しているテナントがそれぞれのコンテナーの種類に応じて選択できる 2 つの課金モデルが用意されており、独自のビジネス要件に合わせて調整できます。 2 つの課金モデルは、Standardとパススルー課金です。

Standard コンテナーの種類 - 課金プロファイル

標準請求プロファイルでは、すべての従量課金ベースの料金が、アプリケーションを所有または開発するテナントに直接課金されます。 開発者テナントの管理者は、標準コンテナーの種類を作成するときに、有効な課金プロファイルを確立する必要があります。

各テナントで使用できるコンテナーの種類の数には制限があります。 詳細については、「 SharePoint 埋め込み制限」を参照してください。

役割とアクセス許可

• SharePoint Embedded の課金関係を設定する管理者は、Azure サブスクリプションに対する所有者または共同作成者のアクセス許可を持っている必要があります。
• 管理者は、課金コマンドレットを操作するために SharePoint Embedded 管理者またはグローバル管理者ロールを持っている必要があります。

Azure のサブスクリプション

標準の課金コンテナーの種類の場合、グローバル管理者は次の操作を行う必要があります。

• テナントでAzure サブスクリプションを作成する
• Azure サブスクリプションにアタッチされているリソース グループを作成する

課金分類を使用してコンテナーの種類standard作成した後、コンテナーの種類に課金プロファイルをアタッチする必要があります。

課金プロファイルを設定する

コンテナーの種類の課金プロファイルは、次のSharePoint Online 管理シェルを使用して作成されます。

1. 最新バージョンのSharePoint Online 管理シェルをダウンロードしてインストールする
2. スタート画面からSharePoint Online 管理シェルを開き、「sharepoint」と入力し、[SharePoint Online 管理シェル] を選択します。
3. テナントに関連付けられている管理者資格情報を指定して、 Connect-SPOService コマンドレットを使用して SPO サービスに接続します。 詳細については、 Connect-SPOService の使用方法に関するページを参照してください。 . コンテナーの種類の標準課金プロファイルを作成するには、次のコマンドレットを使用します。

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

注:

SharePoint Embedded の課金関係を設定する管理者は、Azure サブスクリプションに対する所有者または共同作成者のアクセス許可を持ち、SharePoint Embedded Administrator ロールまたはグローバル管理者ロールを割り当てる必要があります。

すべてのコンテナーの種類には、所有アプリケーションが必要です。

1 つの所有アプリで所有できるコンテナーの種類は一度に 1 つだけです。

Azure サブスクリプションは、任意の数のコンテナーの種類にアタッチできます。

上記のコマンドレットが SubscriptionNotRegistered エラーで失敗した場合は、 Microsoft.Syntex がサブスクリプションのリソース プロバイダーとして登録されていないためです。 コマンドレットは、リソース プロバイダーの登録要求を代わりに送信しますが、完了するまで数分かかります。 5 ~ 10 分待ってから、コマンドレットが成功するまでやり直してください。

標準コンテナーの種類の課金プロファイルを更新するには、次のコマンドレットを使用します。

Set-SPOContainerType -ContainerTypeId <ContainerTypeId> [-AzureSubscriptionId <AzureSubscriptionId>] [-ResourceGroup <ResourceGroup>]

注:

標準コンテナーの種類の課金設定は、SharePoint Online 管理シェルを使用して行われます。 今後、この操作は Microsoft Graph 操作として使用できるようになります。

コンテナーの種類Standard - パススルー課金

パススルー課金では、従量課金ベースの料金は、SharePoint Embedded アプリケーション (消費テナント) を使用するために登録されたテナントに直接課金されます。 開発者テナントの管理者は、パススルー SharePoint Embedded コンテナーの種類を作成するときに、Azure課金プロファイルを設定する必要はありません。

顧客に直接課金されるコンテナーの種類の場合は、コンテナーの種類の作成時にdirectToCustomer課金分類を使用します。 パススルー課金コンテナーの種類では、課金プロファイルをアタッチする必要はありません。

コンテナーの種類が使用中のテナントに 登録されたら 、使用しているテナント管理者 (SharePoint 管理者またはグローバル管理者) は、SharePoint Embedded アプリケーションを使用するために、使用しているテナントに課金プロファイルを設定する必要があります。

テナントを使用して課金プロファイルを設定する

1. Microsoft 365 管理センターで、[セットアップ] を選択し、[課金とライセンス] セクションを表示します。 [従量課金制サービスのアクティブ化] を選択します。

   

2. [ Go to Pay as you go services]\(サービスに移動\) を選択します。

3. [Syntex サービス] で [アプリ] を選択し、[アプリ] パネルで [SharePoint Embedded] を選択します。

   

   注:

   Syntex サービスで構成されたサブスクリプションには、Azure課金ポータルでの使用料金が反映されます。

コンテナーの種類の構成

開発者管理は、Create fileStorageContainerType エンドポイントを呼び出すときに構成を適用できます。 または、 Update fileStorageContainerType エンドポイントを呼び出して、既存のコンテナーの種類を再構成することもできます。

重要

コンテナーの種類の設定の更新には、使用しているすべてのテナントで新しい値がレプリケートされるまでに最大 24 時間 かかる場合があります。 使用しているテナントがコンテナーの種類の設定でオーバーライドを適用した場合、新しい値は適用されず、オーバーライドはそのまま残ります。 一部の設定は新しいコンテンツにのみ適用され、コンテナーの種類の既存のコンテンツには適用されません (たとえば、ストレージ サイズ、検出可能性が有効など)。

コンテナーの種類でサポートされるすべての設定については、「 fileStorageContainerTypeSettings リソースの種類」を参照してください。

コンテナーの種類の表示

開発者管理は、List fileStorageContainerType エンドポイントを使用して、テナントで作成したすべての SharePoint Embedded コンテナーの種類を表示できます。

コンテナーの種類の登録

コンテナーを作成して操作するには、コンテナーの種類を [使用しているテナント] に 登録 する必要があります。 所有するアプリケーションは、 create fileStorageContainerTypeRegistration エンドポイントを呼び出すことによって、コンテナーの種類のアクセス許可を定義します。

コンテナーの種類の削除

開発者管理は、テナント内の試用版コンテナーの種類のみを削除できます。 標準コンテナーの種類の削除はまだサポートされていません。 コンテナーの種類を削除するには、まず、削除されたコンテナー コレクションを含め、そのコンテナーの種類のすべてのコンテナーを削除する必要があります。 コンテナーを削除するには、「テナント 管理の使用」を参照してください。すべてのコンテナーが削除されると、開発者管理者は、Delete fileStorageContainerType エンドポイントを使用してコンテナーの種類を削除できます。