Verwende App-Speicher, um Dateien zu speichern, zu organisieren und zu verwalten, die von deiner laufenden App verwendet werden, einschließlich Bildern, Videos, Dokumenten und Benutzer-Uploads.

Bevor du App-Speicher verwendest, verbinde das Projekt mit Atoms Cloud. Wenn es nicht verbunden ist, bitte den Agent, Atoms Cloud zu verbinden, oder folge Atoms Cloud.

App-Speicher in Atoms Cloud verstehen

App-Speicher speichert Dateien, die dein Projekt behalten und darauf zugreifen muss. Er ist getrennt von strukturierten Daten, die in deiner Datenbank gespeichert sind, von in Chat hochgeladenen Dateien und von den Dateien, aus denen der Code deines Projekts besteht.

Wichtige Begriffe

• Bucket: Der Hauptcontainer zum Speichern und Gruppieren zusammengehöriger Dateien. Du kannst dir einen Bucket wie einen Speicherbereich für eine Dateikategorie vorstellen. Jeder Bucket ist entweder auf Public oder Private gesetzt, was steuert, wer auf die darin enthaltenen Dateien zugreifen kann.
• Ordner: Eine optionale Möglichkeit, Dateien innerhalb eines Buckets zu organisieren. Ordner funktionieren wie die Ordner auf deinem Computer und können dabei helfen, größere Dateisammlungen einfacher zu verwalten.
• Objekt: Eine einzelne Datei, die in einem Bucket oder Ordner gespeichert ist, z. B. ein Bild, ein Dokument, ein Video oder eine andere hochgeladene Datei.
• Objektschlüssel: Der eindeutige Pfad, mit dem identifiziert wird, wo eine Datei innerhalb eines Buckets gespeichert ist. Zum Beispiel könnte images/profile/avatar.png der Objektschlüssel für ein Bild sein, das in einem images/profile-Ordner gespeichert ist.

Public oder Private wählen

Wähle den Bucket-Typ, bevor du ihn erstellst:

Bucket-Typ	Verwendung
Private	Sensible, kontospezifische oder von Benutzern hochgeladene Dateien.
Public	Nicht sensible Dateien, die absichtlich sicher öffentlich zugänglich gemacht werden können.

Verwende Private für sensible oder benutzerspezifische Dateien. Wenn ein Zugriffsfehler auftritt, ändere den Bucket nicht zu Public, nur um die Datei zugänglich zu machen. Stelle stattdessen sicher, dass deine App prüft, ob die Person, die die Datei anfordert, die Berechtigung hat, darauf zuzugreifen.

App-Speicher in Atoms Cloud öffnen

1. Öffne dein Projekt auf einem Desktop-Gerät.
2. Wähle in derselben Symbolleiste des Arbeitsbereichs, in der sich der App-Viewer befindet, Atoms Cloud aus.
3. Wähle App-Speicher in der Atoms Cloud-Seitenleiste aus.

Berechtigungen in App-Speicher

App-Speicher verwendet deine Rolle im Arbeitsbereich. Sowohl Editors als auch workspace owners können den Speicher für Projekte verwalten, die sie öffnen können. Personen, die keine Mitglieder des Arbeitsbereichs sind, können den App-Speicher des Projekts nicht öffnen oder verwalten.

Die Einstellung des Buckets auf Public oder Private ändert nicht, wer ihn in Atoms Cloud verwalten kann. Diese Einstellung steuert, wie die laufende App Zugriff auf die Dateien bereitstellen kann; die Berechtigungen des Arbeitsbereichs steuern, wer den Speicher im Atoms Cloud-Arbeitsbereich verwalten kann.

Einen Bucket erstellen

Eine App kann bis zu 10 Buckets haben. Erstelle separate Buckets, wenn verschiedene Dateigruppen unterschiedliche Zugriffseinstellungen benötigen oder zur einfacheren Organisation getrennt bleiben sollen.

1. Wähle auf der Seite App-Speicher Create Bucket aus.
2. Gib unter Bucket Name einen eindeutigen Namen für den Bucket ein. Der Name muss:
   • 3–63 Zeichen enthalten;
   • nur Kleinbuchstaben, Zahlen und Bindestriche verwenden; und
   • mit einem Buchstaben oder einer Zahl beginnen und enden.
3. Wähle unter Bucket Type Private oder Public. Standardmäßig ist Public ausgewählt. Stelle daher sicher, dass du vor dem Fortfahren die gewünschte Zugriffsstufe auswählst.
4. Wähle Create aus.

Der neue Bucket erscheint auf der Seite App-Speicher mit seinem Namen, Typ und Erstellungsdatum. Wähle den Bucket aus, um ihn zu öffnen und seinen Inhalt anzuzeigen.

Wähle Create Bucket in App-Speicher aus.

Bucket-Namen können nach der Erstellung nicht geändert werden, also wähle einen klaren Namen, den du später nicht ändern musst. Wenn deine App bereits 10 Buckets hat, ist Create Bucket nicht mehr verfügbar.

Dateien hochladen und organisieren

Innerhalb eines Buckets kannst du Dateien direkt hochladen oder einen leeren Ordner erstellen, ohne zuerst Dateien hochzuladen.

Einen neuen Ordner erstellen

1. Öffne den Bucket oder Ordner, in dem du den neuen Ordner erstellen möchtest.
2. Wähle Add Folder aus.
3. Gib einen Namen für den Ordner ein und wähle dann Create aus. Ordnernamen können Buchstaben, Zahlen, Punkte (.), Bindestriche (-) und Unterstriche (_) enthalten und dürfen nicht länger als 100 Zeichen sein. Ordnernamen können nach der Erstellung nicht geändert werden.

Benenne den Ordner und wähle dann Create aus.

Dateien hochladen

1. Öffne den Bucket oder Ordner, in dem du die Dateien speichern möchtest.
2. Wähle Upload aus und wähle dann eine oder mehrere Dateien von deinem Gerät aus. Jede Datei kann bis zu 100 MB groß sein.
3. Warte, bis der Upload abgeschlossen ist, und prüfe dann, ob die Dateien in der Liste erscheinen.

Die Dateiliste zeigt für jedes Element Name, Typ, Größe, das Datum der letzten Änderung und verfügbare Aktionen an. Wenn du den Inhalt des aktuellen Ordners neu laden musst, wähle die Schaltfläche refresh aus.

Lade Dateien in den ausgewählten Bucket oder Ordner hoch.

Dateien in der Vorschau anzeigen und verwalten

Wähle eine Datei aus, um File Details zu öffnen. Unterstützte Bilder und Videos können im Bereich in der Vorschau angezeigt werden. Andere Dateitypen zeigen ihre verfügbaren Details an und können weiterhin heruntergeladen werden. Wenn alle Guthaben aufgebraucht sind, zeigt File Details einen Status für aufgebrauchtes Guthaben an, und Download für einzelne Dateien leitet dich statt zum Download zu Upgrade weiter.

Eine Datei verwalten

Öffne ... in der Spalte Actions der Datei und wähle dann:

• Download, um eine lokale Kopie zu speichern, wenn Guthaben verfügbar ist. Wenn alle Guthaben aufgebraucht sind, leitet dich diese Aktion stattdessen zu Upgrade weiter.
• Rename, um den Dateinamen zu ändern. Der neue Name kann Buchstaben, Zahlen, Punkte, Bindestriche und Unterstriche verwenden.
• Delete, um die Datei nach Bestätigung zu entfernen.

Verwende das Aktionsmenü der Datei, um sie herunterzuladen, umzubenennen oder zu löschen.

Mehrere Dateien verwalten

1. Wähle das Kontrollkästchen neben jeder Datei aus. Ordner sind nicht in der Mehrfachauswahl enthalten.
2. Wähle Download, um die ausgewählten Dateien zusammen herunterzuladen, oder wähle Delete.
3. Wenn du löschst, prüfe die Anzahl der ausgewählten Dateien und bestätige mit Delete.

Das Löschen kann in App-Speicher nicht rückgängig gemacht werden. Bevor du eine Datei umbenennst oder löschst, prüfe, ob die App ihren Objektschlüssel noch verwendet. Aktualisiere danach alle gespeicherten Verweise, damit die App nicht weiterhin den alten Schlüssel anfordert.

Eine gespeicherte Datei in deiner App verwenden

Deine App identifiziert jede gespeicherte Datei anhand ihres Bucket-Namens und Objektschlüssels. Der Objektschlüssel zeigt an, wo sich die Datei innerhalb des Buckets befindet. Zum Beispiel könnte images/profile/avatar.png der Objektschlüssel für ein Bild sein, das in einem images/profile-Ordner gespeichert ist.

Speichere den Bucket-Namen und den Objektschlüssel in der Datenbank deiner App, damit die App die Datei später finden kann. Wenn deine App die Datei anzeigen oder herunterladen muss, kann sie diese Angaben verwenden, um eine Zugriffs-URL anzufordern.

Zugriffs-URLs können temporär sein. Speichere sie nicht als permanente App-Daten, hinterlege sie nicht fest in deiner App und teile sie nicht in Chat, Screenshots, Protokollen oder Support-Nachrichten. Speichere stattdessen den Objektschlüssel und fordere eine neue Zugriffs-URL an, wenn auf die Datei zugegriffen werden muss.

Speichere keine API-Schlüssel, Passwörter oder andere Zugangsdaten in App-Speicher. Speichere private Laufzeit-Zugangsdaten in Keys and secrets. Nur der Eigentümer des Arbeitsbereichs kann dort private Laufzeit-Zugangsdaten verwalten. Wenn du ein Editor bist, bitte den Eigentümer des Arbeitsbereichs, die Zugangsdaten hinzuzufügen oder zu aktualisieren.

Aktuelle Limits

Limit	Aktueller Wert
Buckets pro App	10
Größe jeder hochgeladenen Datei	100 MB

Informationen zur aktuellen Cloud-Nutzung und Kapazität findest du unter Cloud & AI Wallet.

FAQ

Mein Speicherplatz ist voll. Wie kann ich Speicher freigeben?

1. Prüfe die aktuelle Speichernutzung und ermittle die größten Chats, Projekte oder Dateien.
2. Lade alles herunter oder sichere alles, was du später möglicherweise noch brauchst.
3. Lösche nur Elemente, die du nicht mehr benötigst. Wenn beim Löschen eines Chats eine Option zum Entfernen zugehöriger Speicherdaten angezeigt wird, wähle sie erst aus, nachdem du bestätigt hast, dass die Daten verworfen werden können.
4. Entferne nicht benötigte große Dateien, aktualisiere dann die Ansicht und prüfe den verfügbaren Speicherplatz erneut.

Das Löschen kann dauerhaft sein und ein Projekt beeinträchtigen, das auf die entfernte Datei verweist. Wenn die Nutzung nach dem Bereinigen nicht sinkt, kontaktiere den Support mit einem Screenshot des Speichers, deinem Plan und dem betroffenen Konto oder Arbeitsbereich. Sende keine Dateiinhalte, es sei denn, dies wird über einen genehmigten Kanal angefordert.