Usa Archivio App per archiviare, organizzare e gestire i file usati dalla tua app in esecuzione, incluse immagini, video, documenti e caricamenti degli utenti.

Prima di usare Archivio App, collega il progetto a Atoms Cloud. Se non è collegato, chiedi all'Agente di collegare Atoms Cloud oppure segui Atoms Cloud.

Comprendere Archivio App in Atoms Cloud

Archivio App archivia i file che il tuo progetto deve conservare e a cui deve accedere. È separato dai dati strutturati archiviati nel tuo Database, dai file caricati in Chat e dai file che compongono il codice del tuo progetto.

Termini chiave

• Bucket: Il contenitore principale usato per archiviare e raggruppare file correlati. Puoi pensare a un bucket come a un'area di archiviazione per una categoria di file. Ogni bucket è impostato come Public o Private, il che controlla chi può accedere ai file al suo interno.
• Folder: Un modo facoltativo per organizzare i file all'interno di un bucket. Le cartelle funzionano come le cartelle sul tuo computer e possono aiutare a gestire più facilmente raccolte di file più grandi.
• Object: Un singolo file archiviato in un bucket o in una cartella, come un'immagine, un documento, un video o un altro file caricato.
• Object key: Il percorso univoco usato per identificare dove è archiviato un file all'interno di un bucket. Ad esempio, images/profile/avatar.png potrebbe essere l'object key di un'immagine archiviata all'interno di una cartella images/profile.

Scegli Public o Private

Scegli il tipo di bucket prima di crearlo:

Tipo di bucket	Usalo per
Private	File sensibili, specifici dell'account o caricati dagli utenti.
Public	File non sensibili che sono intenzionalmente sicuri da esporre pubblicamente.

Usa Private per file sensibili o specifici dell'utente. Se riscontri un errore di accesso, non cambiare il bucket in Public solo per rendere il file accessibile. Assicurati invece che la tua app verifichi che la persona che richiede il file abbia l'autorizzazione per accedervi.

Apri Archivio App in Atoms Cloud

1. Apri il tuo progetto su un dispositivo desktop.
2. Nella stessa barra degli strumenti dello spazio di lavoro in cui si trova Visualizzatore App , seleziona Atoms Cloud.
3. Seleziona Archivio App nella barra laterale di Atoms Cloud.

Autorizzazioni in Archivio App

Archivio App usa il ruolo del tuo spazio di lavoro. Sia gli Editor sia i proprietari dello spazio di lavoro possono gestire l'archiviazione per i progetti che possono aprire. Le persone che non sono membri dello spazio di lavoro non possono aprire o gestire Archivio App del progetto.

L'impostazione Public o Private del bucket non cambia chi può gestirlo in Atoms Cloud. Questa impostazione controlla come l'app in esecuzione può fornire accesso ai file; le autorizzazioni dello spazio di lavoro controllano chi può gestire l'archiviazione dallo spazio di lavoro di Atoms Cloud.

Crea un bucket

Un'app può avere fino a 10 bucket. Crea bucket separati quando gruppi diversi di file richiedono impostazioni di accesso diverse o devono essere tenuti separati per una più facile organizzazione.

1. Nella pagina Archivio App, seleziona Create Bucket.
2. In Bucket Name, inserisci un nome univoco per il bucket. Il nome deve:
   • contenere da 3 a 63 caratteri;
   • usare solo lettere minuscole, numeri e trattini; e
   • iniziare e terminare con una lettera o un numero.
3. In Bucket Type, scegli Private o Public. Public è selezionato per impostazione predefinita, quindi assicurati di scegliere il livello di accesso desiderato prima di continuare.
4. Seleziona Create.

Il nuovo bucket appare nella pagina Archivio App con il suo nome, il tipo e la data di creazione. Seleziona il bucket per aprirlo e visualizzarne il contenuto.

Seleziona Create Bucket in Archivio App.

I nomi dei bucket non possono essere modificati dopo la creazione, quindi scegli un nome chiaro che non dovrai cambiare in seguito. Se la tua app ha già 10 bucket, Create Bucket non sarà più disponibile.

Carica e organizza i file

All'interno di un bucket, puoi caricare file direttamente oppure creare una cartella vuota senza prima caricare alcun file.

Crea una nuova cartella

1. Apri il bucket o la cartella in cui vuoi creare la nuova cartella.
2. Seleziona Add Folder.
3. Inserisci un nome per la cartella, quindi seleziona Create. I nomi delle cartelle possono contenere lettere, numeri, punti (.), trattini (-) e underscore (_) e non possono superare i 100 caratteri. I nomi delle cartelle non possono essere modificati dopo la creazione.

Assegna un nome alla cartella, quindi seleziona Create.

Carica file

1. Apri il bucket o la cartella in cui vuoi archiviare i file.
2. Seleziona Upload, quindi scegli uno o più file dal tuo dispositivo. Ogni file può avere una dimensione massima di 100 MB.
3. Attendi il completamento del caricamento, quindi verifica che i file compaiano nell'elenco.

L'elenco dei file mostra il Name, il Type, la Size, la data di Last Modified e le Actions disponibili di ciascun elemento. Se devi ricaricare il contenuto della cartella corrente, seleziona il pulsante refresh.

Carica file nel bucket o nella cartella selezionata.

Anteprima e gestione dei file

Seleziona un file per aprire File Details. Le immagini e i video supportati possono essere visualizzati in anteprima nel pannello. Gli altri tipi di file mostrano i dettagli disponibili e possono comunque essere scaricati. Se tutti i crediti sono stati usati, File Details mostra uno stato di crediti esauriti e Download per file singolo ti indirizza a Aggiorna invece di scaricare.

Gestisci un file

Apri ... nella colonna Actions del file, quindi scegli:

• Download per salvare una copia locale quando i crediti sono disponibili. Se tutti i crediti sono stati usati, questa azione ti indirizza invece a Aggiorna.
• Rename per cambiare il nome del file. Il nuovo nome può usare lettere, numeri, punti, trattini e underscore.
• Delete per rimuovere il file dopo la conferma.

Usa il menu delle azioni del file per scaricarlo, rinominarlo o eliminarlo.

Gestisci più file

1. Seleziona la casella accanto a ciascun file. Le cartelle non sono incluse nella selezione multipla.
2. Seleziona Download per scaricare insieme i file selezionati oppure seleziona Delete.
3. Se stai eliminando, controlla il numero di file selezionati e conferma Delete.

L'eliminazione non può essere annullata da Archivio App. Prima di rinominare o eliminare un file, verifica se l'app usa ancora la sua object key. Aggiorna poi tutti i riferimenti archiviati in modo che l'app non continui a richiedere la vecchia key.

Usa un file archiviato nella tua app

La tua app identifica ogni file archiviato usando il suo bucket name e la sua object key. L'object key mostra dove si trova il file all'interno del bucket. Ad esempio, images/profile/avatar.png potrebbe essere l'object key di un'immagine archiviata all'interno di una cartella images/profile.

Archivia il bucket name e l'object key nel database della tua app in modo che l'app possa individuare il file in seguito. Quando la tua app deve visualizzare o scaricare il file, può usare questi dettagli per richiedere un URL di accesso.

Gli URL di accesso possono essere temporanei. Non salvarli come dati permanenti dell'app, non inserirli in modo statico nella tua app e non condividerli in Chat, screenshot, log o messaggi di supporto. Archivia invece l'object key e richiedi un nuovo URL di accesso quando è necessario accedere al file.

Non archiviare chiavi API, password o altre credenziali in Archivio App. Archivia le credenziali private di runtime in Chiavi and secrets. Solo il proprietario dello spazio di lavoro può gestire lì le credenziali private di runtime. Se sei un Editor, chiedi al proprietario dello spazio di lavoro di aggiungere o aggiornare la credenziale.

Limiti attuali

Limite	Valore attuale
Bucket per app	10
Dimensione di ogni file caricato	100 MB

Per informazioni attuali su utilizzo e capacità del Cloud, consulta Cloud & AI Wallet.

FAQ

Il mio spazio su disco è pieno. Come posso liberare spazio di archiviazione?

1. Controlla l'utilizzo attuale dello spazio di archiviazione e identifica le chat, i progetti o i file più grandi.
2. Scarica o esegui il backup di tutto ciò di cui potresti aver bisogno in seguito.
3. Elimina solo gli elementi di cui non hai più bisogno. Se l'eliminazione di una chat presenta un'opzione per rimuovere i dati su disco associati, selezionala solo dopo aver confermato che i dati possono essere scartati.
4. Rimuovi i file di grandi dimensioni non necessari, quindi aggiorna e controlla di nuovo lo spazio disponibile.

L'eliminazione può essere permanente e può influire su un progetto che fa riferimento al file rimosso. Se l'utilizzo non diminuisce dopo la pulizia, contatta il Supporto con uno screenshot dello spazio di archiviazione, il tuo piano e l'account o lo spazio di lavoro interessato. Non inviare il contenuto dei file se non richiesto tramite un canale approvato.