Utilisez Stockage de l'App pour stocker, organiser et gérer les fichiers utilisés par votre app en cours d’exécution, y compris les images, les vidéos, les documents et les fichiers téléversés par les utilisateurs.

Avant d’utiliser Stockage de l'App, connectez le projet au Cloud Atoms. S’il n’est pas connecté, demandez à l’Agent de connecter Cloud Atoms ou suivez Cloud Atoms.

Comprendre le Stockage de l'App dans Cloud Atoms

Stockage de l'App stocke les fichiers que votre projet doit conserver et auxquels il doit accéder. Il est distinct des données structurées stockées dans votre Base de données, des fichiers téléversés dans Chat et des fichiers qui composent le code de votre projet.

Termes clés

• Bucket: Le conteneur principal utilisé pour stocker et regrouper des fichiers liés. Vous pouvez considérer un bucket comme une zone de stockage pour une catégorie de fichiers. Chaque bucket est défini comme Public ou Private, ce qui contrôle qui peut accéder aux fichiers qu’il contient.
• Folder: Une manière facultative d’organiser les fichiers dans un bucket. Les dossiers fonctionnent comme les dossiers sur votre ordinateur et peuvent aider à gérer plus facilement de grandes collections de fichiers.
• Object: Un fichier individuel stocké dans un bucket ou un dossier, comme une image, un document, une vidéo ou un autre fichier téléversé.
• Object key: Le chemin unique utilisé pour identifier l’emplacement de stockage d’un fichier dans un bucket. Par exemple, images/profile/avatar.png pourrait être la clé d’objet d’une image stockée dans un dossier images/profile.

Choisir Public ou Private

Choisissez le type de bucket avant de le créer :

Type de bucket	À utiliser pour
Private	Fichiers sensibles, spécifiques au compte ou téléversés par les utilisateurs.
Public	Fichiers non sensibles qui peuvent être exposés publiquement en toute sécurité de manière intentionnelle.

Utilisez Private pour les fichiers sensibles ou spécifiques à un utilisateur. Si vous rencontrez une erreur d’accès, ne changez pas le bucket en Public simplement pour rendre le fichier accessible. Assurez-vous plutôt que votre app vérifie que la personne qui demande le fichier a l’autorisation d’y accéder.

Ouvrir le Stockage de l'App dans Cloud Atoms

1. Ouvrez votre projet sur un appareil de bureau.
2. Dans la même barre d’outils de l’espace de travail où se trouve la Visionneuse d'App , sélectionnez Cloud Atoms.
3. Sélectionnez Stockage de l'App dans la barre latérale de Cloud Atoms.

Autorisations dans le Stockage de l'App

Le Stockage de l'App utilise votre rôle dans l’espace de travail. Les Editors comme les workspace owners peuvent gérer le stockage des projets qu’ils peuvent ouvrir. Les personnes qui ne sont pas membres de l’espace de travail ne peuvent pas ouvrir ni gérer le Stockage de l'App du projet.

Le paramètre Public ou Private du bucket ne change pas qui peut le gérer dans Cloud Atoms. Ce paramètre contrôle la manière dont l’app en cours d’exécution peut fournir l’accès aux fichiers ; les autorisations de l’espace de travail contrôlent qui peut gérer le stockage depuis l’espace de travail Cloud Atoms.

Créer un bucket

Une app peut avoir jusqu’à 10 buckets. Créez des buckets séparés lorsque différents groupes de fichiers nécessitent des paramètres d’accès différents ou doivent être conservés séparément pour une organisation plus simple.

1. Sur la page Stockage de l'App, sélectionnez Create Bucket.
2. Sous Bucket Name, saisissez un nom unique pour le bucket. Le nom doit :
   • contenir 3 à 63 caractères ;
   • utiliser uniquement des lettres minuscules, des chiffres et des traits d’union ; et
   • commencer et se terminer par une lettre ou un chiffre.
3. Sous Bucket Type, choisissez Private ou Public. Public est sélectionné par défaut, alors assurez-vous de choisir le niveau d’accès souhaité avant de continuer.
4. Sélectionnez Create.

Le nouveau bucket apparaît sur la page Stockage de l'App avec son nom, son type et sa date de création. Sélectionnez le bucket pour l’ouvrir et afficher son contenu.

Sélectionnez Create Bucket dans le Stockage de l'App.

Les noms de bucket ne peuvent pas être modifiés après leur création, alors choisissez un nom clair que vous n’aurez pas besoin de changer plus tard. Si votre app a déjà 10 buckets, Create Bucket ne sera plus disponible.

Téléverser et organiser des fichiers

À l’intérieur d’un bucket, vous pouvez téléverser des fichiers directement ou créer un dossier vide sans téléverser de fichiers au préalable.

Créer un nouveau dossier

1. Ouvrez le bucket ou le folder dans lequel vous souhaitez créer le nouveau dossier.
2. Sélectionnez Add Folder.
3. Saisissez un nom pour le dossier, puis sélectionnez Create. Les noms de dossier peuvent contenir des lettres, des chiffres, des points (.), des traits d’union (-) et des traits de soulignement (_), et ne peuvent pas dépasser 100 caractères. Les noms de dossier ne peuvent pas être modifiés après leur création.

Nommez le dossier, puis sélectionnez Create.

Téléverser des fichiers

1. Ouvrez le bucket ou le folder dans lequel vous souhaitez stocker les fichiers.
2. Sélectionnez Upload, puis choisissez un ou plusieurs fichiers depuis votre appareil. Chaque fichier peut faire jusqu’à 100 MB.
3. Attendez la fin du téléversement, puis vérifiez que les fichiers apparaissent dans la liste.

La liste des fichiers affiche le Name, le Type, la Size, la date de Last Modified et les Actions disponibles pour chaque élément. Si vous devez recharger le contenu du dossier actuel, sélectionnez le bouton refresh.

Téléversez des fichiers dans le bucket ou le dossier sélectionné.

Prévisualiser et gérer les fichiers

Sélectionnez un fichier pour ouvrir File Details. Les images et vidéos prises en charge peuvent être prévisualisées dans le panneau. Les autres types de fichiers affichent leurs détails disponibles et peuvent toujours être téléchargés. Si tous les crédits sont utilisés, File Details affiche un état d’épuisement des crédits, et le Download d’un seul fichier vous redirige vers Mettre à niveau au lieu de lancer le téléchargement.

Gérer un fichier

Ouvrez ... dans la colonne Actions du fichier, puis choisissez :

• Download pour enregistrer une copie locale lorsque des crédits sont disponibles. Si tous les crédits sont utilisés, cette action vous redirige vers Mettre à niveau à la place.
• Rename pour modifier le nom du fichier. Le nouveau nom peut utiliser des lettres, des chiffres, des points, des traits d’union et des traits de soulignement.
• Delete pour supprimer le fichier après confirmation.

Utilisez le menu d’actions du fichier pour le télécharger, le renommer ou le supprimer.

Gérer plusieurs fichiers

1. Cochez la case à côté de chaque fichier. Les dossiers ne sont pas inclus dans la sélection par lot.
2. Sélectionnez Download pour télécharger ensemble les fichiers sélectionnés, ou sélectionnez Delete.
3. En cas de suppression, vérifiez le nombre de fichiers sélectionnés et confirmez Delete.

La suppression ne peut pas être annulée depuis le Stockage de l'App. Avant de renommer ou de supprimer un fichier, vérifiez si l’app utilise encore sa clé d’objet. Mettez ensuite à jour toutes les références stockées afin que l’app ne continue pas à demander l’ancienne clé.

Utiliser un fichier stocké dans votre app

Votre app identifie chaque fichier stocké à l’aide de son bucket name et de sa object key. La clé d’objet indique où le fichier se trouve dans le bucket. Par exemple, images/profile/avatar.png pourrait être la clé d’objet d’une image stockée dans un dossier images/profile.

Stockez le nom du bucket et la clé d’objet dans la base de données de votre app afin qu’elle puisse localiser le fichier plus tard. Lorsque votre app doit afficher ou télécharger le fichier, elle peut utiliser ces informations pour demander une URL d’accès.

Les URL d’accès peuvent être temporaires. Ne les enregistrez pas comme données permanentes de l’app, ne les codez pas en dur dans votre app et ne les partagez pas dans Chat, des captures d’écran, des journaux ou des messages d’assistance. Stockez plutôt la clé d’objet et demandez une nouvelle URL d’accès lorsque le fichier doit être consulté.

Ne stockez pas de clés API, de mots de passe ou d’autres identifiants dans le Stockage de l'App. Stockez les identifiants d’exécution privés dans Clés and secrets. Seul le propriétaire de l’espace de travail peut y gérer les identifiants d’exécution privés. Si vous êtes un Editor, demandez au propriétaire de l’espace de travail d’ajouter ou de mettre à jour l’identifiant.

Limites actuelles

Limite	Valeur actuelle
Buckets par app	10
Taille de chaque fichier téléversé	100 MB

Pour les informations actuelles sur l’utilisation et la capacité du Cloud, consultez Cloud & AI Wallet.

FAQ

Mon espace disque est plein. Comment libérer de l’espace de stockage ?

1. Vérifiez l’utilisation actuelle du stockage et identifiez les chats, projets ou fichiers les plus volumineux.
2. Téléchargez ou sauvegardez tout ce dont vous pourriez avoir besoin plus tard.
3. Supprimez uniquement les éléments dont vous n’avez plus besoin. Si la suppression d’un chat présente une option pour supprimer les données disque associées, sélectionnez-la uniquement après avoir confirmé que les données peuvent être supprimées.
4. Supprimez les fichiers volumineux inutiles, puis actualisez et vérifiez à nouveau l’espace disponible.

La suppression peut être permanente et peut affecter un projet qui référence le fichier supprimé. Si l’utilisation ne diminue pas après le nettoyage, contactez le support avec une capture d’écran du stockage, votre forfait et le compte ou l’espace de travail concerné. N’envoyez pas le contenu des fichiers, sauf si cela est demandé via un canal approuvé.