Limites de l’API du module de stockage Drive

Le module de stockage Drive augmente le stockage mutualisé des comptes TrekMail. Les agents peuvent consulter l’état et les tarifs du module, mais ils ne peuvent pas l’acheter, modifier sa capacité, le résilier ni changer l’abonnement de quelque autre manière que ce soit par des opérations d’écriture API ou MCP.

Cette page explique cette limite afin que l’automatisation reste utile sans transformer les décisions de facturation en actions d’agents exécutées en arrière-plan.

Ce que les agents peuvent consulter

Avec drive:addon:read, une intégration peut consulter :

• L’état actuel du module Drive.
• La capacité et la période de facturation lorsqu’un module est actif.
• Les options tarifaires pour les devises prises en charge.
• Les informations d’aperçu de la résiliation, lorsqu’elles sont disponibles.
• Le contexte d’utilisation du stockage qui aide à déterminer si une capacité supplémentaire peut être nécessaire.

Cela suffit aux agents de génération de rapports, tableaux de bord, moniteurs de stockage et processus d’assistance.

Ce que les agents ne peuvent pas modifier

L’API et le serveur MCP ne proposent aucune opération d’écriture permettant de :

• Acheter un module Drive.
• Augmenter ou réduire la capacité du module.
• Changer la période de facturation ou le moyen de paiement.
• Résilier ou réactiver le module.
• Déclencher des débits de carte ou des modifications d’abonnement.

Il n’existe aucun champ d’application drive:addon:write. Le serveur MCP ne comporte aucun outil d’achat, de redimensionnement ou de résiliation.

Pourquoi cette limite existe

Les changements de stockage peuvent avoir une incidence sur les factures, la devise, la planification de la capacité et la conservation des données. Un agent utile peut remarquer que l’utilisation est élevée et expliquer les possibilités, mais l’étape finale de facturation doit avoir lieu dans le tableau de bord, où une personne voit le prix et confirme l’action.

Cette mesure limite également les dégâts en cas de mauvaise configuration d’un agent. Un jeton de surveillance du stockage à portée restreinte peut signaler que « vous approchez de votre quota » sans pouvoir dépenser d’argent ni supprimer de la capacité.

Modèle d’automatisation recommandé

1. Accordez drive:addon:read et le champ d’application de lecture Drive approprié.
2. Demandez à l’agent de vérifier l’utilisation et l’état du module.
3. Si l’espace de stockage devient insuffisant, demandez à l’agent de préparer une courte recommandation.
4. Renvoyez l’utilisateur vers la page du module Drive dans le tableau de bord pour tout achat, changement de capacité ou résiliation.

Exemple de réponse d’un agent :

Votre compte utilise 91% du stockage mutualisé. Le module Drive actuel est actif. Au vu de la croissance actuelle, pensez à vérifier la capacité du module dans le tableau de bord avant le prochain lot de téléversements.

États de grâce et de lecture seule

Lorsqu’un module est résilié, une période de grâce peut permettre de continuer à lire les fichiers tandis que les écritures sont restreintes. Les agents doivent considérer cette situation comme un état à signaler et non comme un problème à corriger automatiquement. L’utilisateur peut décider de restaurer la capacité, de supprimer des fichiers ou d’exporter des données.

Articles connexes

• Tarifs et offres du module Drive
• Champs d’application et autorisations de l’API Drive
• Comprendre les quotas de stockage