Types de conteneur SharePoint Embedded

Un type de conteneur est une ressource SharePoint Embedded qui définit la relation, les privilèges d’accès et la responsabilité de facturation entre une application SharePoint Embedded et un ensemble de conteneurs. En outre, le type de conteneur définit des comportements sur l’ensemble de conteneurs.

Chaque type de conteneur est fortement couplé à une application SharePoint Embedded, appelée application propriétaire. Le développeur d’applications propriétaires est responsable de la création et de la gestion de ses types de conteneurs. SharePoint Embedded impose une relation 1:1 entre l’application propriétaire et un type de conteneur.

Un type de conteneur est représenté sur chaque conteneur instance en tant que propriété immuable (ContainerTypeID) et est utilisé dans l’ensemble de l’écosystème SharePoint Embedded, notamment :

• Autorisation d’accès : une application SharePoint Embedded doit être associée à un type de conteneur pour obtenir l’accès aux instances de conteneur de ce type. Une fois associée, l’application a accès à toutes les instances de conteneur de ce type. Le privilège d’accès réel est déterminé par le paramètre d’autorisation application-ContainerTypeID. L’application propriétaire par défaut dispose d’un privilège d’accès complet à toutes les instances de conteneur du type de conteneur avec lequel elle est fortement couplée. En savoir plus sur l’autorisation Incorporée SharePoint.
• Exploration facile : les types de conteneurs peuvent être créés à des fins d’évaluation, ce qui permet aux développeurs d’explorer le développement d’applications SharePoint Embedded et d’évaluer ses fonctionnalités gratuitement.
• Facturation : les types de conteneurs à des fins non industrielles sont facturables et doivent être créés avec un abonnement Azure. L’utilisation des conteneurs est mesurée et facturée. En savoir plus sur le contrôle et l’expérience de facturation SharePoint Embedded.
• Comportements configurables : le type de conteneur définit les comportements sélectionnés pour toutes les instances de conteneur de ce type. En savoir plus sur la définition de la configuration du type de conteneur.

Remarque

1. Vous devez spécifier l’objectif du type de conteneur que vous créez au moment de la création. Un type de conteneur défini à des fins d’évaluation ne peut pas être converti pour la production . ou vice versa.
2. Les types de conteneur Standard et passthrough ne peuvent pas être convertis une fois créés. Si vous souhaitez convertir un type de conteneur standard en facturation directe ou vice versa, vous devez supprimer et recréer le type de conteneur.

Configuration requise pour les clients

• Un instance actif de SharePoint est requis dans votre client Microsoft 365.
• Les utilisateurs qui s’authentifient dans les types de conteneurs et conteneurs SharePoint Embedded doivent se trouver dans Microsoft Entra ID (membres et invités)
• Une inscription d’application Microsoft Entra ID doit être configurée pour la gestion des types de conteneur. Pour plus d’informations, consultez Authentification et autorisation SharePoint Embedded.

Remarque

Une licence Office n’est pas nécessaire pour collaborer sur des documents Microsoft Office stockés dans un conteneur.

Création de types de conteneurs

SharePoint Embedded a deux types de conteneurs différents que vous pouvez créer.

1. Type de conteneur d’évaluation. Utilise la classification de trial facturation.
2. Standard type de conteneur. Utilise la standard classification de facturation ou directToCustomer .

Pour créer un type de conteneur, votre application Microsoft Entra ID doit disposer de l’autorisation d’application FileStorageContainerType.Manage.All sur le locataire propriétaire. Votre application Microsoft Entra ID doit appeler le point de terminaison Create fileStorageContainerType pour le compte d’un administrateur SharePoint Embedded :

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

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

Remarque

Vous devez remplacer :

• {ContainerTypeName} avec un nom convivial pour votre application SharePoint Embedded.
• {ApplicationId} par l’ID de votre ID d’application correctement configuré.
• {BillingClassification} trialavec , standardou directToCustomer. Poursuivez votre lecture pour comprendre ce que chacun signifie.

En outre, vous pouvez configurer votre type de conteneur lors de la création à l’aide du settings champ .

Type de conteneur d’essai

Un type de conteneur peut être créé à des fins d’évaluation/développement et n’est lié à aucun profil de facturation Azure. Les types de conteneurs d’essai permettent aux développeurs d’explorer le développement d’applications SharePoint Embedded et d’évaluer ses fonctionnalités gratuitement. Pour les types de conteneurs d’essai, le locataire développeur est identique au locataire consommateur. Chaque développeur ne peut avoir qu’un seul type de conteneur avec trial classification de facturation dans son locataire à la fois. Le type de conteneur d’essai est valide jusqu’à 30 jours, mais peut être supprimé à tout moment pendant cette période.

Vous pouvez facilement configurer un type de conteneur d’essai à l’aide de l’extension SharePoint Embedded Visual Studio Code.

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.

Standard types de conteneurs (non-trials)

Un type de conteneur standard peut être utilisé dans des environnements de production. Chaque locataire peut avoir 25 types de conteneurs à la fois. Standard types de conteneur n’ont pas les mêmes restrictions que les types de conteneur d’essai, mais ils ont toujours des limites. Pour plus d’informations, voir SharePoint Embedded Limits.

Pour en savoir plus sur les compteurs de paiement à l’utilisation pris en charge, reportez-vous à l’article Compteurs SharePoint Embedded .

Profil de facturation

SharePoint Embedded est une offre basée sur la consommation, paiement à l’utilisation (PAYG), ce qui signifie que vous payez uniquement pour ce que vous utilisez. SharePoint Embedded fournit deux modèles de facturation que le locataire qui développe l’application SharePoint Embedded peut sélectionner pour les types de conteneurs respectifs, en les adaptant à leurs besoins métier uniques. Les deux modèles de facturation sont Standard et Facturation directe.

Standard type de conteneur - avec profil de facturation

Avec le profil de facturation standard, tous les frais basés sur la consommation sont directement facturés au locataire qui possède ou développe l’application. L’administrateur du locataire développeur doit établir un profil de facturation valide lors de la création d’un type de conteneur standard.

Il existe des limites quant au nombre de types de conteneurs que chaque locataire peut avoir. Pour plus d’informations, voir SharePoint Embedded Limits.

Rôles et autorisations

• L’administrateur qui configure la relation de facturation pour SharePoint Embedded doit disposer des autorisations de propriétaire ou de contributeur sur l’abonnement Azure.
• L’administrateur doit avoir un rôle Administrateur SharePoint Incorporé ou Administrateur général pour utiliser les applets de commande de facturation.

Abonnement Azure

Pour le type de conteneur de facturation standard, l’administrateur général doit :

• Créer un abonnement Azure dans votre location
• Créer un groupe de ressources attaché à l’abonnement Azure

Après avoir créé le type de conteneur avec standard la classification de facturation, vous devez attacher un profil de facturation au type de conteneur.

Définir le profil de facturation

Le profil de facturation pour votre type de conteneur est créé à l’aide de SharePoint Online Management Shell :

1. Téléchargez et installez la dernière version de SharePoint Online Management Shell
2. Ouvrez SharePoint Online Management Shell à partir de l’écran d’accueil, tapez sharepoint, puis sélectionnez SharePoint Online Management Shell.
3. Connectez-vous au service SPO à l’aide Connect-SPOService de l’applet de commande en fournissant les informations d’identification d’administrateur associées à la location. Pour plus d’informations, consultez Comment utiliser Connect-SPOService. . Pour créer le profil de facturation standard pour votre type de conteneur, utilisez l’applet de commande suivante :

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

Remarque

L’administrateur qui configure une relation de facturation pour SharePoint Embedded doit disposer des autorisations de propriétaire ou d’contributeur sur l’abonnement Azure et se voir attribuer le rôle Administrateur SharePoint Embedded ou Administrateur général.

Chaque type de conteneur doit avoir une application propriétaire.

Une application mono-propriétaire ne peut posséder qu’un seul type de conteneur à la fois.

Un abonnement Azure peut être attaché à n’importe quel nombre de types de conteneurs.

Si l’applet de commande ci-dessus échoue avec une erreur SubscriptionNotRegistered, c’est parce que Microsoft.Syntex n’est pas inscrit en tant que fournisseur de ressources dans l’abonnement. L’applet de commande envoie une demande d’inscription de fournisseur de ressources en votre nom, mais elle prend quelques minutes. Attendez 5 à 10 minutes et réessayez jusqu’à ce que l’applet de commande réussisse.

Pour mettre à jour le profil de facturation d’un type de conteneur standard, utilisez l’applet de commande suivante :

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

Remarque

La configuration de la facturation pour les types de conteneurs standard s’effectue via le SharePoint Online Management Shell. À l’avenir, cette opération sera disponible en tant qu’opération Microsoft Graph.

Standard type de conteneur : facturation directe

Avec la facturation directe, les frais basés sur la consommation sont facturés directement au locataire inscrit pour utiliser l’application SharePoint Embedded (locataire consommateur). Les administrateurs du locataire développeur n’ont pas besoin de configurer un profil de facturation Azure lors de la création d’un type de conteneur SharePoint Embedded passthrough.

Pour les types de conteneurs destinés à être directement facturés à un client, utilisez la classification de facturation lors de la directToCustomercréation du type de conteneur. Pour les types de conteneur de facturation directe, il n’est pas nécessaire d’attacher un profil de facturation.

Une fois le type de conteneur inscrit dans le locataire consommateur, l’administrateur client consommateur (administrateur SharePoint ou administrateur général) doit configurer le profil de facturation dans le locataire consommateur pour utiliser l’application SharePoint Embedded.

Configurer le profil de facturation dans le client consommateur

1. Dans Centre d’administration Microsoft 365, sélectionnez Configuration, puis affichez la section Facturation et licences. Sélectionnez Activer les services de paiement à l’utilisation.

   

2. Sélectionnez Accéder aux services Payer à l’utilisation.

3. Sélectionnez Applications sous Services Syntex pour, puis sélectionnez SharePoint Embedded dans le panneau Applications

   

   Remarque

   L’abonnement configuré dans les services Syntex reflète les frais de consommation dans le portail de facturation Azure.

Configuration des types de conteneurs

Le Administration développeur peut appliquer la configuration lors de l’appel du point de terminaison Create fileStorageContainerType. Ils peuvent également appeler le point de terminaison Update fileStorageContainerType pour reconfigurer un type de conteneur existant.

Importante

La mise à jour des paramètres sur un type de conteneur peut prendre jusqu’à 24 heures avant que les nouvelles valeurs soient répliquées sur tous les locataires consommateurs. Si un locataire consommateur est appliqué sur les paramètres de type de conteneur, les nouvelles valeurs ne sont pas appliquées et les remplacements restent en place. Certains paramètres s’appliquent uniquement au nouveau contenu et non au contenu existant pour le type de conteneur (par exemple, taille de stockage, détectabilité activée, etc.).

Pour plus d’informations sur tous les paramètres pris en charge par les types de conteneurs, consultez type de ressource fileStorageContainerTypeSettings.

Affichage des types de conteneurs

Le Administration développeur peut afficher tous les types de conteneurs SharePoint Embedded qu’il a créés sur son locataire à l’aide du point de terminaison List fileStorageContainerType.

Inscription des types de conteneurs

Pour créer et interagir avec des conteneurs, vous devez inscrire le type de conteneur dans le locataire consommateur. L’application propriétaire définit les autorisations pour le type de conteneur en appelant le point de terminaison Create fileStorageContainerTypeRegistration .

Suppression des types de conteneurs

Le Administration développeur ne peut supprimer que les types de conteneur d’essai dans leur locataire. La suppression des types de conteneur standard n’est pas encore prise en charge. Pour supprimer un type de conteneur, vous devez d’abord supprimer tous les conteneurs de ce type de conteneur, y compris de la collection de conteneurs supprimée. Pour supprimer des conteneurs, reportez-vous à Consommation de Administration de locataire. Une fois tous les conteneurs supprimés, les administrateurs de développeurs peuvent supprimer le type de conteneur à l’aide du point de terminaison Delete fileStorageContainerType.