Créer et configurer un type de conteneur

S’applique à : Développeur

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 responsabilité de facturation et les comportements sélectionnés pour les conteneurs créés par votre application.

Si vous commencez, suivez démarrage rapide : Créer votre première application avec VS Code. Utilisez ensuite cet article pour les décisions d’évaluation, standard et directe.

Pour choisir entre les modèles monolocataires et multilocataires, consultez Choisir un modèle d’application.

Comprendre la relation de type de conteneur

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

SharePoint Embedded nécessite 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.

L’ID est utilisé pour l’autorisation d’accès, l’exploration d’essai, la facturation et les comportements configurables.

Remarque

Le API Graph Microsoft ( Create fileStorageContainerType) est délégué uniquement et peut être appelé par tout utilisateur non-invité propriétaire-locataire. 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 la production

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

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

Vous ne pouvez pas convertir un type de facturation standard en facturation directe ultérieurement.

Cas d’utilisation	Type de conteneur
Preuve de concept locale	Type de conteneur d’essai
Le propriétaire de l’application paie	Standard type de conteneur avec profil de facturation
Le locataire client paie	Standard type de conteneur avec facturation directe

Importante

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

Configuration requise

Avant de créer un type de conteneur, vérifiez que vous disposez des points suivants :

• Un locataire Microsoft 365 avec SharePoint disponible.
• Une inscription d’application Microsoft Entra ID pour l’application propriétaire.
• Un compte de membre non invité dans le locataire propriétaire.
• Pour la facturation standard, un abonnement Azure et un groupe de ressources.
• Pour la configuration de facturation standard, les autorisations de propriétaire ou de contributeur sur 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é dans le locataire 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 d’administration à l’échelle du locataire, consultez Créer des applications avec PowerShell.

• Les utilisateurs qui s’authentifient dans des 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, à l’exception des expériences exceptionnelles documentées telles que les mentions.

Créer un type de conteneur d’essai

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 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 trial classification de facturation.

Les restrictions suivantes sont appliquées aux types de conteneurs d’essai :

• Le locataire peut avoir jusqu’à cinq conteneurs du type de conteneur. Cela inclut les conteneurs actifs et ceux de la corbeille.
• Chaque conteneur a jusqu’à 1 Go d’espace de stockage.
• 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 dans la version d’évaluation status pour créer un nouveau 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é dans d’autres locataires consommateurs.

Créer un type de conteneur standard avec facturation du propriétaire de l’application

Utilisez la facturation standard lorsque le locataire développeur ou propriétaire de l’application paie pour la consommation.

Chaque locataire peut avoir jusqu’à 25 types de conteneurs standard à la fois.

1. Créez ou identifiez l’application Microsoft Entra ID propriétaire.
2. Créez le type de conteneur avec la standard classification de facturation.
3. Joignez un profil de facturation Azure avec l’extension SharePoint Embedded Visual Studio Code ou un flux de facturation géré par l’administrateur.
4. Enregistrez l’ID de type de conteneur.
5. Poursuivez l’inscription dans le locataire consommateur.

Remarque

Si la configuration de la facturation échoue avec SubscriptionNotRegistered, attendez plusieurs minutes et 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 locataire consommateur paie la consommation.

1. Créez ou identifiez l’application Microsoft Entra ID propriétaire.
2. Créez le type de conteneur avec la directToCustomer classification de facturation.
3. Inscrivez le type de conteneur dans le locataire consommateur.
4. Faites en sorte que l’administrateur client qui consomme active les services de paiement à l’utilisation.

Importante

Le locataire consommateur doit terminer la configuration de la facturation avant qu’une application directe puisse être utilisée correctement.

L’administrateur 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 SharePoint Embedded pour activer la facturation de l’application.

Configurer l’application de Entra propriétaire

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

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

Demandez l’autorisation d’application Microsoft Graph FileStorageContainerTypeReg.Selected pour l’inscription du type de conteneur sur les locataires qui consomment.

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 qui possède ce type.
URL de redirection de l’application	Utilisez l’URL où les fichiers de cette application doivent être redirigés.
Modèle de facturation	Choisissez version d’évaluation, standard ou directe au moment de la création.

Attention

L’ID de type de conteneur et l’ID d’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 leur création.

Les paramètres disponibles sont les suivants :

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

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

Importante

La mise à jour des paramètres sur un type de conteneur peut prendre jusqu’à 24 heures pour être répliquée sur tous les locataires consommateurs. Si un paramètre appliqué par un locataire consommateur remplace, 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.

Vous avez besoin d’un accès propriétaire ou contributeur aux abonnements de facturation 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 fileStorageContainerType API Microsoft Graph.

Opération	API
Créer un type de conteneur	Create fileStorageContainerType
Répertorier les types de conteneurs	List fileStorageContainerType
Mettre à jour un type de conteneur	Mettre à jour fileStorageContainerType
Supprimer un type de conteneur	Delete fileStorageContainerType

Les résultats de la liste sont filtrés par propriété. Les utilisateurs non administrateurs voient uniquement les types de conteneurs sur lesquels l’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 locataire. Pour connaître les paramètres que vous pouvez configurer, consultez fileStorageContainerTypeSettings.

Vous ne pouvez supprimer que les types de conteneur d’essai ; 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ée.

Comprendre la dépendance de facturation

Pour la facturation du propriétaire de l’application, le locataire développeur joint un abonnement Azure et un groupe de ressources.

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

Pour plus d’informations, voir Compteurs SharePoint Embedded et Gestion de la facturation SharePoint Embedded.

Lien vers l’intégration multilocataire

Une application multilocataire a généralement un locataire propriétaire et un ou plusieurs locataires 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 de l’administrateur.
3. Inscrire les autorisations d’application de type de conteneur.
4. Configurez la facturation directe lorsque le locataire consommateur paie.
5. Valider la création et l’accès au conteneur.

Étapes suivantes

Inscrivez les autorisations dans Inscrire les autorisations d’application.