Créer et gérer des conteneurs

S’applique à : Développeur

Créez et gérez des conteneurs une fois votre type de conteneur créé, inscrit et autorisé. Les conteneurs sont l’unité de stockage de base dans SharePoint Embedded.

Configurez l’authentification et l’autorisation avant d’appeler les API de conteneur.

Comprendre les conteneurs

Tous les fichiers et documents SharePoint Embedded sont stockés dans des conteneurs.

Un conteneur :

  • Appartient à un client Microsoft 365 qui consomme.
  • Possède un ID de type de conteneur immuable.
  • Stocke le contenu de votre application.
  • Définit une limite pour l’appartenance et les autorisations.
  • Est accessible via Microsoft Graph.

Pour obtenir une vue d’ensemble de l’architecture, consultez Architecture d’application incorporée SharePoint.

Connaître le cycle de vie

Un cycle de vie de conteneur typique inclut :

  1. Créez un conteneur.
  2. Ajoutez ou confirmez des membres.
  3. Chargez et gérez des fichiers.
  4. Lisez ou mettez à jour les métadonnées du conteneur.
  5. Recycler un conteneur lorsqu’il n’est plus actif.
  6. Restaurez un conteneur recyclé si nécessaire.
  7. Supprimez définitivement les conteneurs pendant le nettoyage.

Continuez à charger, télécharger et gérer les fichiers pour les opérations de contenu.

Configuration requise

Avant de créer des conteneurs, vérifiez les points suivants :

  • Le type de conteneur existe.
  • Le type de conteneur est enregistré dans le client consommateur.
  • L’application a obtenu le consentement de Microsoft Graph FileStorageContainer.Selected .
  • L’application dispose d’autorisations de type conteneur pour l’opération.
  • L’application acquiert son jeton en tant que client confidentiel, car la création de conteneurs l’exige.
  • Pour les appels délégués, l’utilisateur connecté peut recevoir le rôle de conteneur nécessaire.
  • Pour les types de conteneurs d’évaluation, vous êtes dans les limites de la version d’évaluation.

Importante

Les types de conteneurs d’essai peuvent créer jusqu’à cinq conteneurs, y compris des conteneurs actifs et des conteneurs dans la corbeille.

Utiliser un client confidentiel pour créer des conteneurs

La création d’un conteneur nécessite une application cliente confidentielle . Un client confidentiel détient des informations d’identification, telles qu’un certificat ou une clé secrète client, et acquiert des jetons à partir d’un composant qui maintient ces informations d’identification privées, comme un service ou un back-end d’application web.

Les appels de conteneur de création qui utilisent un jeton d’une application cliente publique échouent, car les jetons clients publics sont accessibles à l’utilisateur final et peuvent être réutilisés à l’insu de l’application. Les clients publics incluent les applications monopage, les applications mobiles et les applications de bureau.

Cette exigence s’applique à la fois à la création déléguée et à la création d’application uniquement :

  • Pour la création déléguée, acquérez le jeton avec le flux de code d’autorisation et des informations d’identification client, puis appelez Microsoft Graph à partir de votre serveur principal.
  • Pour la création d’applications uniquement, acquérez le jeton avec le flux d’informations d’identification du client, qui est toujours confidentiel.

Si votre application dispose d’un serveur frontal client public, acheminez la création de conteneurs via un service principal confidentiel au lieu d’appeler Microsoft Graph à partir du client.

Pour plus d’informations, voir Applications clientes publiques et clientes confidentielles.

Choisissez la création déléguée ou d’une application uniquement

Utilisez l’accès délégué lorsqu’un utilisateur lance la création, l’utilisateur doit être responsable ou l’utilisateur créateur doit devenir propriétaire du conteneur.

Utilisez l’accès à l’application uniquement lorsqu’un service provisionne des conteneurs, qu’aucun utilisateur n’est présent et que l’application est autorisée à créer des conteneurs.

Remarque

Un utilisateur qui crée un conteneur par le biais d’appels délégués se voit automatiquement attribuer le rôle Propriétaire.

Créer un conteneur

Utilisez Microsoft Graph pour créer un conteneur de stockage de fichiers pour votre type de conteneur inscrit.

Pour la forme d’API canonique, consultez Créer un fichierStorageContainer.

Étapes de mise en œuvre :

  1. Acquérir un jeton Microsoft Graph valide auprès d’un client confidentiel.
  2. Incluez les informations de type de conteneur cible requises par l’API.
  3. Envoyez la demande de création.
  4. Stockez l’ID de conteneur renvoyé.
  5. Stockez les métadonnées d’affichage dont votre application a besoin.
  6. Attribuez ou confirmez l’appartenance pour les scénarios délégué ;

Conseil

Stockez l’ID de conteneur dans la base de données de votre application en tant que lien durable entre votre objet métier et le conteneur SharePoint Embedded.

Créer un conteneur dans Visual Studio Code

Pour le développement d’évaluation, l’extension Visual Studio Code peut créer des conteneurs.

  1. Ouvrez la vue SharePoint Embedded.
  2. Développez le type de conteneur d’évaluation inscrite.
  3. Cliquez avec le bouton droit sur Conteneurs.
  4. Sélectionnez Créer un conteneur.
  5. Entrez un nom.
  6. Vérifiez que le conteneur s’affiche sous le type de conteneur.

Consultez Démarrage rapide : créer votre première application avec VS Code pour le flux d’extension.

Lister les conteneurs

Répertoriez les conteneurs pour afficher les conteneurs disponibles, valider l’approvisionnement ou exécuter la maintenance.

Pour la forme API canonique, consultez Lister les conteneurs.

Lors de la liste des conteneurs :

  • Utilisez l’accès à l’application uniquement pour les scénarios d’inventaire des services.
  • Utilisez l’accès délégué uniquement lorsque le contexte utilisateur est approprié.
  • Gérer la pagination.
  • Mappez les résultats aux données de votre application.

Remarque

Les conteneurs de liste déléguée sont actuellement renvoyés 403 Forbidden si l’utilisateur n’a pas OneDrive. Cette dépendance ne s’applique pas aux appels de liste uniquement destinés à l’application.

Obtenir un conteneur

Obtenez un conteneur lorsque vous avez besoin des métadonnées les plus récentes avant d’agir.

Cette opération permet de vérifier que le conteneur existe, de lire les propriétés d’affichage, de vérifier le type de conteneur, de vérifier la case activée de l’état avant les opérations de fichier et de confirmer la restauration.

Lier les implémentations au type de ressource fileStorageContainer.

Mettre à jour les métadonnées du conteneur

Mettre à jour les métadonnées lorsque les propriétés prises en charge changent.

Avant la mise à jour :

  1. Vérifiez que l’application dispose de l’autorisation de type Write de conteneur.
  2. Vérifiez que l’utilisateur délégué dispose d’un rôle approprié.
  3. Lire l’état actuel du conteneur.
  4. Appliquer uniquement les modifications prévues.
  5. Validez la réponse.

Supprimer ou recycler un conteneur

Recyclez ou supprimez un conteneur lorsqu’il n’est plus actif.

Avant la suppression :

  • Vérifiez que l’appelant a l’autorisation.
  • Vérifiez que votre application a archivé des références professionnelles.
  • Décidez si le conteneur doit être recyclé en premier.
  • Indiquer aux utilisateurs comment restaurer un conteneur recyclé.

L’extension de Visual Studio Code inclut des fonctionnalités de recyclage et de récupération pour le développement d’évaluations.

Restaurer un conteneur recyclé

Un flux de restauration doit :

  1. Identifiez le conteneur recyclé.
  2. Vérifiez que l’appelant a l’autorisation.
  3. Restaurez le conteneur.
  4. Actualiser l’état de l’application.
  5. Vérifiez que les fichiers et les métadonnées sont disponibles.
  6. Avertir l’utilisateur.

Importante

Pour les types de conteneurs d’évaluation, les conteneurs dans la corbeille sont toujours pris en compte dans la limite de cinq conteneurs.

Supprimer définitivement des conteneurs

Supprimez définitivement uniquement lorsque vous êtes sûr que le conteneur n’est plus nécessaire.

Vous devez supprimer tous les conteneurs d’un type de conteneur, y compris les conteneurs supprimés, avant de supprimer le type de conteneur lui-même.

Utilisez la suppression permanente pour le nettoyage d’essai, la suppression de données de test, le retrait d’un type de conteneur ou le respect des exigences du cycle de vie.

Valider les opérations du cycle de vie

Créez un test de fumée :

  1. Créez un conteneur de test.
  2. Récupérez-le par ID.
  3. Répertoriez les conteneurs et confirmez qu’ils apparaissent.
  4. Mettez à jour une valeur de métadonnées prise en charge.
  5. Chargez un petit fichier.
  6. Recyclez ou supprimez le conteneur.
  7. Restaurez-la si prise en charge.
  8. Supprimez-le définitivement pendant le nettoyage.

Résoudre les problèmes liés au cycle de vie

Symptôme Vérifier
Échec de la création Inscription et Create autorisation.
Échec de la création à partir d’un navigateur, d’un appareil mobile ou d’une application de bureau Le jeton provient d’un client public. Achetez-le plutôt auprès d’un client confidentiel.
Échec de la création déléguée Consentement de l’utilisateur, acquisition de jetons client confidentiels et comportement d’attribution de rôle.
Échec de la liste pour l’utilisateur délégué Dépendance de OneDrive mentionnée dans l’article d’authentification.
Échec de la suppression Delete d’autorisation et le rôle Propriétaire utilisateur.
Échec de la création de la version d’évaluation Les conteneurs actifs et recyclés ont peut-être atteint la limite.
Échec de la suppression du type de conteneur Tous les conteneurs actifs et supprimés doivent d’abord être supprimés.

Étapes suivantes

Ajoutez des opérations de fichier dans Charger, télécharger et gérer des fichiers.

  • Last updated on