Créer et configurer un type de conteneur

S’applique à : Développeur

Ajoutez le serveur SharePoint Embedded MCP à un agent de codage en un simple clic :

Ajouter à Visual Studio Code

Vous utilisez la version préliminaire ? Ajoutez le serveur aux participants au programme Visual Studio Code Insiders.

Pour les autres clients MCP, enregistrez le serveur avec la même npx commande :

# 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

Installez l’extension SharePoint Embedded pour Visual Studio Code Pour créer un type de conteneur, configurer l’application propriétaire et la facturation, enregistrer le type de conteneur, créer des conteneurs et charger un exemple d’application à partir d’une vue guidée dans l’éditeur :

Obtenez l’extension à partir de la Place de marché Visual Studio

Créez un type de conteneur SharePoint Embedded pour votre application afin de créer des conteneurs ou de stocker des fichiers. Un type de conteneur définit l’accès, la facturation, la responsabilité et les comportements sélectionnés pour les conteneurs créés par votre application.

Si vous commencez tout juste à démarrer, suivez Démarrage rapide : Créer votre première application avec VS Code. Utilisez ensuite cet article pour les décisions de procès, standard et directes.

Pour choisir d’abord entre les modèles monolocataire et multilocataire, consultez Choisir un modèle d’application.

Comprendre la relation de type conteneur

Un type de conteneur est fortement couplé à une application Microsoft Entra ID, appelée application propriétaire.

SharePoint Embedded requiert une relation un-à-un entre une application propriétaire et un type de conteneur.

L’ID de type de conteneur est stocké sur chaque conteneur en tant que propriété immuable.

SharePoint Embedded utilise l’ID pour l’autorisation d’accès, l’exploration d’essai, la facturation et les comportements configurables.

Remarque

L’API Graph Microsoft (Create fileStorageContainerType) est déléguée uniquement et peut être appelée par n’importe quel utilisateur client propriétaire d’un invité. L’appelant n’a pas besoin d’un rôle d’administrateur et est automatiquement affecté en tant que propriétaire du nouveau type de conteneur.

Choisir la version d’évaluation ou de production

Choisissez l’objectif du type de conteneur lorsque vous le créez.

Vous ne pouvez pas convertir un type de conteneur d’évaluation en production ultérieurement.

Vous ne pouvez pas modifier un type de conteneur de facturation standard à facturation directe ultérieurement.

Cas d’utilisation	Type de conteneur
Preuve de concept locale	Type de conteneur d’évaluation
Le locataire développeur paie	Type de conteneur avec facturation standard
La consommation de paiements par client	Type de conteneur avec facturation directe

Importante

Si vous choisissez un objectif ou un modèle de facturation incorrect, vous devez recréer le type de conteneur.

Configuration requise

Avant de créer un type de conteneur, assurez-vous d’avoir les éléments suivants :

• Un client Microsoft 365 avec SharePoint disponible.
• Inscription d’une application Microsoft Entra ID pour l’application propriétaire.
• Un compte de membre non-invité dans le client propriétaire.
• Pour la facturation standard, un abonnement et un groupe de ressources Azure.
• Pour gérer la facturation d’un type de conteneur standard existant en tant que non-administrateur, être propriétaire de ce type de conteneur. Les administrateurs SharePoint Embedded et les administrateurs généraux peuvent gérer n’importe quel type de conteneur à facturation standard dans le locataire développeur.
• Pour la configuration de facturation standard, l’accès Propriétaire ou Contributeur à l’abonnement Azure.

Remarque

• La création d’un type de conteneur via Microsoft Graph nécessite uniquement l’autorisation FileStorageContainerType.Manage.All déléguée. Tout utilisateur non invité du client propriétaire peut en créer un et est automatiquement affecté en tant que propriétaire de ce type de conteneur. Pour les opérations administratives à l’échelle du client, consultez Créer des applications avec PowerShell.

• Les utilisateurs qui s’authentifient dans les conteneurs doivent exister dans Microsoft Entra ID en tant que membres ou invités. Une licence Office n’est pas nécessaire pour collaborer sur des documents Office stockés dans un conteneur, sauf pour des expériences exceptionnelles documentées telles que les mentions.

Créer un type de conteneur d’évaluation

Utilisez un type de conteneur d’évaluation pour l’évaluation.

Vous pouvez en créer un avec l’extension SharePoint Embedded Visual Studio Code ou Microsoft Graph.

Le chemin d’accès à Visual Studio Code est le plus rapide pour une première application. Consultez Démarrage rapide : Créer votre première application avec VS Code.

Pour Microsoft Graph, créez le type de conteneur avec la classification de trial facturation.

Les restrictions suivantes s’appliquent aux types de conteneurs d’évaluation :

• Le client peut avoir jusqu’à cinq conteneurs de ce type. Cela inclut les conteneurs actifs et ceux qui se trouvent dans la corbeille.
• Chaque conteneur dispose d’un espace de stockage allant jusqu’à 1 Go.
• Le type de conteneur expire au bout de 30 jours, et l’accès à tous les conteneurs existants de ce type de conteneur est ensuite supprimé.
• Le développeur doit supprimer définitivement tous les conteneurs d’un type de conteneur existant en status d’évaluation afin de créer un type de conteneur pour la version d’évaluation. Cela inclut les conteneurs de la collection de conteneurs supprimés.
• Le type de conteneur est limité pour fonctionner dans le locataire développeur. Il ne peut pas être déployé chez d’autres clients consommateurs.

Créer un type de conteneur avec facturation standard

Utilisez la facturation standard lorsque le locataire développeur paie pour la consommation.

Chaque client peut créer jusqu’à 25 types de conteneurs au total. L’un d’entre eux peut être un type de conteneur d’essai gratuit ; Les autres sont des types de conteneur standard (facturés).

1. Créez ou identifiez l’application Microsoft Entra ID propriétaire.
2. Créez le type de conteneur avec la classification de standard facturation.
3. Gérez la facturation sur le type de conteneur. L’extension SharePoint Embedded Visual Studio Code et le serveur SharePoint Embedded Model Context Protocol (MCP) permettent la gestion de la facturation pour les types de conteneurs à facturation standard. Les administrateurs et administrateurs généraux SharePoint Embedded peuvent également utiliser PowerShell pour gérer la facturation.
4. Enregistrez l’ID du type de conteneur.
5. Continuez jusqu’à l’inscription dans le locataire consommateur.

Remarque

Si la configuration de la facturation échoue avec SubscriptionNotRegistered, patientez quelques minutes, puis réessayez. L’inscription Microsoft.Syntex du fournisseur de ressources peut prendre du temps.

Créer un type de conteneur de facturation directe

Utilisez la facturation directe lorsque le client consommateur paie pour la consommation.

1. Créez ou identifiez l’application Microsoft Entra ID propriétaire.
2. Créez le type de conteneur avec la classification de directToCustomer facturation.
3. Inscrivez le type de conteneur dans le locataire consommateur.
4. Demandez à un administrateur de facturation ou à un administrateur général dans le client consommateur d’activer les services de paiement à l’utilisation.

Importante

Le client consommateur doit terminer la configuration de facturation avant qu’une application directe puisse être utilisée avec succès.

Un administrateur de facturation ou un administrateur général du client consommateur active les services de paiement à l’utilisation dans le Centre dʼadministration Microsoft 365. Dans Configurer>la facturation et les licences, sélectionnez Activer les services de paiement à l’utilisation.

Sous Services Syntex pour, sélectionnez Applications, puis sélectionnez SharePoint Embedded pour activer la facturation de l’application.

Configurer la propriétaire de l’application Microsoft Entra ID

Configurez l’application afin qu’elle puisse posséder exactement un type de conteneur.

Demandez des autorisations Microsoft Graph pour l’accès SharePoint Embedded.

Demander l’autorisation de l’application Microsoft Graph FileStorageContainerTypeReg.Selected pour l’inscription de type conteneur sur les clients consommateurs.

Utilisez des URI de redirection qui correspondent à vos clients de développement et de production.

Utilisez les informations d’identification appropriées pour les flux délégués ou d’application uniquement.

Pour plus d’informations sur l’authentification, consultez Configurer l’authentification et l’autorisation.

Définir les propriétés de base

Propriété	Aide
Nom du type de conteneur	Utilisez un nom durable qui correspond à votre charge de travail.
ID d’application propriétaire	Utilisez l’inscription d’application propriétaire de ce type.
URL de redirection de l’application	Utilisez l’URL où les fichiers de cette application doivent rediriger.
Modèle de facturation	Choisissez la version d’évaluation, la facturation standard ou la facturation directe au moment de la création.

Attention

L’ID de type de conteneur et l’ID de l’application propriétaire ne peuvent pas être mis à jour ultérieurement.

Configurer le comportement du type de conteneur

Les développeurs peuvent configurer les comportements sélectionnés après la création.

Les paramètres disponibles sont les suivants :

• urlTemplate
• isDiscoverabilityEnabled
• isSharingRestricted

Utilisez l’API fileStorageContainerType de mise à jour Microsoft Graph pour les mises à jour de type de conteneur prises en charge. Pour connaître les paramètres administratifs à l’échelle du locataire, consultez Créer des applications avec PowerShell.

Importante

La réplication de la mise à jour des paramètres sur un type de conteneur sur tous les clients consommateurs peut prendre jusqu’à 24 heures . Si un client consommateur a appliqué des remplacements, ces remplacements restent en place. Certains paramètres s’appliquent uniquement au nouveau contenu, et non au contenu existant.

Afficher et mettre à jour les types de conteneurs

Utilisez Microsoft Graph pour répertorier et mettre à jour les types de conteneurs.

Un propriétaire de type de conteneur non administrateur peut mettre à jour les types de conteneurs dont il est propriétaire. Ils peuvent également créer et gérer le profil de facturation standard.

Le propriétaire a besoin d’un accès propriétaire ou contributeur à l’abonnement Azure pour les modifications de facturation.

Gérer les types de conteneurs avec Microsoft Graph

Vous pouvez également gérer les types de conteneurs avec les API Microsoft fileStorageContainerType Graph.

Opération	API
Créer un type de conteneur	Create fileStorageContainerType
Lister les types de conteneurs	list fileStorageContainerType
Mettre à jour un type de conteneur	Update fileStorageContainerType
Supprimer un type de conteneur	Delete fileStorageContainerType

Les résultats de la liste sont filtrés par propriétaire. Les utilisateurs non-administrateurs voient uniquement les types de conteneurs pour lesquels une autorisation leur a été accordée, tandis que les administrateurs SharePoint Embedded et les administrateurs généraux voient chaque type de conteneur dans le client. Pour connaître les paramètres que vous pouvez configurer, consultez la section fileStorageContainerTypeSettings.

Vous ne pouvez supprimer que les types de conteneurs d’évaluation ; La suppression des types de conteneurs standard n’est pas encore prise en charge. Avant de supprimer un type de conteneur, supprimez tous les conteneurs de ce type, y compris les conteneurs de la collection de conteneurs supprimés.

Comprendre la dépendance de facturation

Pour la facturation standard, le locataire développeur attache un abonnement et un groupe de ressources Azure.

Pour la facturation directe, le client consommateur active les services de paiement à l’utilisation.

Pour plus d’informations, consultez Gestion des compteurs SharePoint Embedded et de la facturation SharePoint Embedded.

Lien vers l’intégration multilocataire

Une application mutualisée a généralement un client propriétaire et un ou plusieurs clients consommateurs.

Utilisez cette séquence pour chaque locataire consommateur :

1. Créez le type de conteneur dans le locataire propriétaire.
2. Demandez à l’administrateur client consommateur d’accorder le consentement administrateur.
3. Enregistrez les autorisations d’application de type conteneur.
4. Configurez la facturation directe lorsque le client consommateur paie.
5. Validez la création et l’accès aux conteneurs.

Étapes suivantes

Inscrire les autorisations dans Enregistrer les autorisations d’application.