Caricare una directory con la CLI dosya

Usa dosya upload ./sample-source --recursive --workspace ws_example per caricare una cartella da riga di comando. Sostituisci il segnaposto dello spazio di lavoro con il tuo ID effettivo. Per impostazione predefinita dosya crea o riutilizza una cartella di destinazione chiamata sample-source e conserva i percorsi dei file al suo interno; --contents inserisce invece il contenuto direttamente nella destinazione scelta.

L’immagine è un’illustrazione. Le opzioni e i limiti seguenti sono stati verificati rispetto all’attuale analisi degli argomenti e implementazione del trasferimento.

Autenticati e scegli la destinazione

Installa la CLI e verifica dosya upload --help. In Profilo → Chiavi API, scegli Crea una chiave API e poi Accesso completo per esplorare e caricare. Consenti API REST nelle restrizioni dei protocolli e, se necessario, limita la chiave allo spazio di lavoro desiderato. Salva la chiave completa dopo Genera la chiave.

dosya auth login
dosya workspace list
dosya workspace use ws_example

Inserisci la credenziale al prompt nascosto Enter API key:. Usa l’ID restituito dall’elenco degli spazi di lavoro al posto di ws_example; l’ultimo comando salva quel valore come predefinito. Puoi omettere questo passaggio e fornire invece --workspace a ogni caricamento. Una chiave DOSYA_API_KEY fornita dall’ambiente prevale su quella salvata. La CLI ha una sola configurazione salvata, senza profili distinti per account: controlla l’account autenticato e lo spazio di lavoro prima di trasferire file privati.

I tuoi permessi devono consentire il caricamento e la creazione delle cartelle necessarie. Una chiave di solo caricamento non può eseguire la sequenza di esplorazione e verifica; una chiave di sola lettura non può caricare. Regole dello spazio di lavoro, limiti della chiave, quota di archiviazione e restrizioni sulle cartelle si applicano anche a una chiave ad accesso completo. Per scegliere una cartella esistente, ottieni l’ID da dosya ls --workspace ws_example, poi passa --folder fld_example. La cartella deve appartenere allo spazio scelto ed essere accessibile con i tuoi permessi.

Controlla l’albero locale prima del caricamento

• Le directory annidate vengono esplorate ricorsivamente. Sono inclusi i file regolari nascosti, compresi .env e i file il cui nome inizia con un punto; questo comando non dispone di file o opzioni di esclusione. Se la directory contiene segreti o file che non intendi caricare, prepara una directory di origine con i soli file desiderati.
• Link simbolici annidati, socket e dispositivi vengono saltati, con il messaggio Skipping … non-regular file(s) nell’output normale. Il percorso principale fornito viene risolto con una normale stat del file system: non usare un link simbolico come origine se vuoi evitare la sua destinazione.
• Vengono create solo le directory necessarie ai file accettati. Le sottodirectory vuote non vengono copiate e un albero senza file regolari termina con Directory is empty.
• I file attivi con lo stesso nome nella stessa cartella di destinazione vengono acquisiti come nuove versioni, non come file distinti. È un caricamento, non un confronto di sincronizzazione incrementale: ripeterlo può creare versioni anche per file invariati. I file presenti solo in remoto non vengono rimossi.

Mantieni invariati i file di origine fino al termine del trasferimento e della verifica. Scegli prima una nuova cartella di prova se la destinazione contiene già copie di lavoro.

Procedura: carica la directory

dosya upload ./sample-source --recursive --workspace ws_example --parallel 3

Per inserirla sotto una cartella remota esistente:

dosya upload ./sample-source --recursive --workspace ws_example --folder fld_example

Per saltare il livello aggiuntivo sample-source:

dosya upload ./sample-source --recursive --contents --workspace ws_example --folder fld_example

Racchiudi tra virgolette i percorsi locali con spazi. La forma breve di --recursive è -r; quella di --workspace è -w. Il numero predefinito di file simultanei è 3, con massimo 16; --parallel o -c lo imposta e la CLI lo riduce per le directory se il limite di sessioni dello spazio di lavoro è inferiore. Per un singolo file multipart, questa opzione controlla invece le parti parallele.

I file regolari piccoli, fino a 5 MiB, sono raggruppati in richieste con un massimo di 200 file e 48 MiB di dati. Fino a 4 gruppi vengono elaborati contemporaneamente, entro il limite di operazioni simultanee scelto. Se un gruppo non è utilizzabile, il client passa ai caricamenti individuali. I file oltre 50 MiB usano caricamenti riprendibili con parti da 10 MiB; l’ultima può essere più piccola. Sono soglie di trasferimento, non un diritto a caricare file di qualsiasi dimensione: regole sulle estensioni, dimensione massima, quota del membro e spazio disponibile possono ancora impedirlo.

La CLI legge le regole dello spazio di lavoro prima di creare cartelle. L’output normale elenca fino a 10 percorsi rifiutati e continua con i file accettati; il fatto che le violazioni siano state saltate non prova quindi che tutta la directory sia stata caricata. Con --json, qualsiasi file rifiutato produce files_rejected e il codice di uscita 2 prima della creazione delle cartelle. Se la stima supera la quota, il client avvisa e lascia decidere al server per ogni file; alcuni caricamenti possono non riuscire.

Leggi il risultato e verifica l’albero remoto

L’output normale riporta prima il numero di file e la dimensione totale. L’avanzamento interattivo viene scritto su stderr, seguito da Done. N uploaded, M failed. Usa JSON se uno script richiede ID e risultati per file:

dosya upload ./sample-source --recursive --workspace ws_example --json > upload-result.json

Il risultato della directory contiene uploaded, failed, failures e files; le voci riuscite includono ID, nome, dimensione e versione del file. Controlla anche il codice di uscita del processo. Un errore di trasferimento o di creazione di una cartella produce il codice di uscita 1, anche se altri file sono stati completati. Le categorie globali includono 2 utilizzo, 3 autenticazione, 4 rete, 5 accesso negato e 75 manutenzione; il successo è 0.

Apri File nello stesso spazio di lavoro ed esamina la cartella principale creata e quelle annidate. Confronta nomi, dimensioni e numeri previsti con l’albero locale, poi scarica e apri un file rappresentativo. Controlla tutti i percorsi saltati e gli avvisi. Un errore di creazione della cartella segnalato da un avviso può far finire i file discendenti in una cartella superiore disponibile: il solo numero di successi non prova che la struttura sia corretta.

Interruzioni, ripresa e nuovi tentativi sicuri

Ctrl+C mostra Interrupted. e termina con 130. File completati e cartelle create restano nello spazio di archiviazione cloud; l’interruzione non annulla la transazione e non li rimuove.

Per i file multipart il client scrive <local-file>.dosya-upload prima di inviare i byte e lo rimuove al completamento. Un caricamento successivo dello stesso file può riutilizzare le parti salvate se dimensione in byte e data di modifica corrispondono ancora e gli URL di ripresa appartengono all’host API configurato. Conserva il file ausiliario per riprovare e non modificarlo. I caricamenti a flusso singolo vengono ritentati fino a 3 volte in caso di errori temporanei, dopo attese di 1, 3 e 8 secondi; un rifiuto 4xx non viene trattato come errore temporaneo.

Per una directory interrotta, usa il riepilogo e l’elenco di destinazione per identificare i file incompleti, poi riprova a caricarli singolarmente usando gli ID delle cartelle esistenti. Ripetere alla cieca l’intero albero carica di nuovo anche i file riusciti e può creare versioni aggiuntive. La scansione include i file ausiliari regolari .dosya-upload, quindi non considerare una ripetizione ricorsiva una ripresa filtrata. Se una vecchia sessione non è più utilizzabile, rimuovi solo il file ausiliario relativo quando la riavvii intenzionalmente; rimuoverlo in locale non modifica i file già salvati nel cloud.

Risolvi il rifiuto specifico

Output	Prossima azione
Use --recursive to upload a directory.	Aggiungi --recursive dopo aver controllato l’albero di origine.
Workspace ID required.	Fornisci --workspace o imposta un valore predefinito con dosya workspace use.
Every file was refused by this workspace's upload rules.	Controlla le restrizioni su estensione e dimensione; non riprovare con dati invariati.
--version-of can only be used with a single file.	Usa un normale caricamento ricorsivo oppure carica un solo file sostitutivo indicando esplicitamente il file di cui creare una versione.
Warning: failed to create folder	Non affidarti ai conteggi: controlla dove sono finiti i file e correggi i permessi o la destinazione della cartella prima di riprovare.

L’opzione --version-of è disponibile per un file, non per una directory. Permette di indicare esplicitamente un file esistente. Il recupero delle versioni dipende dal periodo di conservazione della cronologia dello spazio di lavoro, quindi conserva la cartella locale originale fino al termine della verifica.

Risultato previsto

I file accettati compaiono sotto la destinazione scelta con i percorsi relativi previsti, oppure direttamente nella destinazione se hai usato —contents. Il risultato completo include percorsi saltati o rifiutati ed errori parziali oltre ai file caricati; esaminali prima di considerare completo il caricamento della cartella.

Guide correlate

• Installare la CLI dosya
• Cronologia delle versioni dei file