Comprendre les types de conteneurs et les conteneurs

S’applique à : Développeur

Utilisez cet article pour comprendre les deux objets de stockage principaux dans SharePoint Embedded : les types de conteneurs et les conteneurs.

Pour obtenir des informations de référence complètes sur la création et la gestion, voir Types de conteneurs SharePoint Embedded.

Modèle d’objet

SharePoint Embedded stocke les fichiers et les documents dans des conteneurs, qui sont regroupés par type de conteneur. Vous créez un type de conteneur avant de pouvoir créer des conteneurs pour une application.

Objet	Ce qu’il représente	Qui le gère habituellement
Type de conteneur	Relation entre une application et un ensemble de conteneurs, y compris l’accès, le comportement et la responsabilité de facturation.	Développeur ou propriétaire du type de conteneur.
Container	Limite de stockage et de sécurité pour les fichiers et les dossiers.	Application via Microsoft Graph et administrateurs pour les opérations de gouvernance.

Concept de type de conteneur

Un type de conteneur est une ressource SharePoint Embedded. Il définit :

• Application propriétaire.
• Privilèges d’accès entre les applications et les conteneurs.
• Modèle de responsabilité de facturation.
• Comportements sélectionnés qui s’appliquent aux conteneurs de ce type.

Chaque type de conteneur est fortement couplé à une application SharePoint Embedded, appelée application propriétaire. SharePoint Embedded nécessite une relation 1:1 entre l’application propriétaire et le type de conteneur. Le développeur d’application propriétaire est responsable de la création et de la gestion du type de conteneur.

Identité du type de conteneur

Le type de conteneur est représenté sur chaque conteneur sous la forme d’une propriété immuable nommée ContainerTypeID. La propriété est utilisée dans l’écosystème SharePoint Embedded. Elle affecte :

• Autorisation d’accès.
• Exploration de l’essai.
• Facturation.
• Comportement configurable.

Importante

Planifiez soigneusement le type de conteneur. Certains choix de création, tels que la version d’évaluation ou la production et la facturation standard ou directe, ne peuvent pas être convertis après la création. Pour basculer, vous devez supprimer et recréer le type de conteneur.

Containers

Un conteneur est l’unité de stockage de base dans SharePoint Embedded et définit une limite de sécurité et de conformité. Les applications créent des conteneurs dans la consommation de locataires à l’aide de Microsoft Graph.

Files, les dossiers, les métadonnées, les versions et le contenu de la corbeille sont stockés dans des conteneurs et sont soumis aux limites SharePoint Embedded actuelles.

Pour connaître les limites, consultez Comprendre les limites et les modèles d’appel.

Propriété

La propriété du type de conteneur et la résidence du conteneur sont différentes. Le locataire propriétaire crée le type de conteneur. Le locataire consommateur utilise le type de conteneur et héberge les conteneurs.

Tout le contenu du conteneur créé via l’application est stocké dans la limite du locataire Microsoft 365 du client consommateur.

Pour l’architecture du locataire, consultez Comprendre l’architecture des applications et des locataires.

Autorisation d’accès

Une application SharePoint Embedded doit être associée à un type de conteneur pour accéder aux conteneurs de ce type. Après l’association, l’application a accès aux conteneurs de ce type en fonction des autorisations de type application-conteneur. L’application propriétaire dispose par défaut d’un privilège d’accès complet pour les conteneurs du type de conteneur auquel elle est couplée. L’accès réel varie également selon que l’application utilise l’accès délégué ou l’accès à l’application uniquement.

Pour la planification des autorisations, consultez Planifier l’authentification et les autorisations.

Types de conteneurs d’essai

Utilisez un type de conteneur d’essai pour explorer le développement SharePoint Embedded sans lier un profil de facturation Azure.

Pour les types de conteneurs d’essai :

• Le locataire développeur est le même que le locataire consommateur.
• Chaque développeur ne peut avoir qu’un seul type de conteneur d’évaluation dans son locataire à la fois.
• La version d’évaluation est valable jusqu’à 30 jours.
• Jusqu’à cinq conteneurs du type de conteneur peuvent être créés, y compris les conteneurs actifs et les conteneurs dans la corbeille.
• Chaque conteneur a jusqu’à 1 Go de stockage.
• Le type de conteneur est limité au locataire développeur.

Un type de conteneur d’essai ne peut pas être converti en production.

Pour créer un type de conteneur d’essai, les développeurs peuvent utiliser l’extension SharePoint Embedded Visual Studio Code ou l’API de type de conteneur Microsoft Graph.

Les types de conteneurs sont créés avec le point de terminaison Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes , à l’aide de la trial classification de facturation. Cet appel nécessite l’autorisation FileStorageContainerType.Manage.All déléguée ; l’accès aux applications uniquement n’est pas pris en charge. L’utilisateur appelant doit être un membre non invité du locataire propriétaire (aucun rôle d’administrateur requis) et est automatiquement affecté en tant que propriétaire du nouveau type de conteneur.

Standard types de conteneurs

Un type de conteneur standard est utilisé pour les scénarios hors version d’évaluation.

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

Standard types de conteneurs sont facturables et doivent utiliser un modèle de facturation.

SharePoint Embedded prend en charge :

• Standard facturation (standardclassification de facturation).
• Facturation directe (directToCustomer classification de facturation).

Pour la sélection de la facturation, consultez Choisir un modèle de facturation.

Standard type de conteneur de facturation

Avec la facturation standard, les frais basés sur la consommation sont facturés au locataire qui possède ou développe l’application.

Le locataire propriétaire attache un profil de facturation après avoir créé le type de conteneur standard.

Créez le type de conteneur avec le point de terminaison Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes à l’aide de la standard classification de facturation, puis joignez un profil de facturation Azure :

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "standard"
}

Type de conteneur de facturation directe

Avec la facturation directe, les frais sont facturés directement au locataire consommateur.

Le développeur crée le type de conteneur avec la directToCustomer classification de facturation et n’attache pas de profil de facturation dans le locataire développeur.

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "directToCustomer"
}

Après l’inscription, un administrateur général du locataire consommateur configure la facturation dans le locataire consommateur.

interaction Administration et développeur

Les développeurs et les administrateurs interagissent avec différentes couches.

Activité	Type de conteneur	Container
Créer la famille de stockage de l’application	Oui	Non
Configurer la relation d’application propriétaire	Oui	Non
Configurer la responsabilité de facturation	Oui	Non
Créer des instances de stockage d’applications	Non	Oui
Stocker des fichiers et des dossiers	Non	Oui
Appliquer la gouvernance spécifique au conteneur	Non	Oui
Supprimer la famille de stockage	Oui, une fois les conteneurs supprimés	Non

Configuration du type de conteneur

Les développeurs peuvent configurer les paramètres de type de conteneur sélectionnés après la création.

Vous pouvez configurer ces paramètres de type de conteneur :

• 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, consultez Créer des applications avec PowerShell.

Inscription

Pour créer et interagir avec des conteneurs dans un locataire consommateur, le type de conteneur doit être inscrit dans ce locataire.

L’application propriétaire appelle l’API d’inscription pour définir les autorisations d’application pour le type de conteneur.

Pour plus d’informations, consultez Inscrire les autorisations d’application de type de conteneur de stockage de fichiers.

Liste de vérification de planification

• Choisissez version d’évaluation ou standard.
• Choisissez la facturation standard ou la facturation directe pour la production.
• Identifiez l’application propriétaire.
• Confirmez le nom du type de conteneur.
• Confirmez le ou les locataires qui consomment.
• Planifier l’inscription du type de conteneur.
• Planifier les autorisations d’application.
• Planifiez les paramètres de type de conteneur requis.
• Planifier le cycle de vie et la suppression des conteneurs.

Étapes suivantes

Planifier l’authentification et l’autorisation : Planifier l’authentification et les autorisations.