dosya.dev CLI ile klasör yükleyin
Çalışma alanı ve klasör bayraklarıyla komut satırından klasör yükleyin. Alt yolları, ilerlemeyi, kısmi hataları ve sürdürülebilir aktarımı izleyin.
Son inceleme
Ekran görüntülerinde İngilizce arayüz gösterilir.
Komut satırından klasör yüklemek için dosya upload ./sample-source --recursive --workspace ws_example kullanın. Çalışma alanı yer tutucusunu gerçek kimlikle değiştirin. dosya.dev varsayılan olarak sample-source adlı hedef klasör oluşturur veya mevcut olanı kullanır. Alt dosya yollarını korur. --contents ise içeriği doğrudan hedefe koyar.

Akış görseli bir çizimdir. Aşağıdaki bayrak ve sınırlar güncel komut ayrıştırıcısı ve aktarım uygulamasıyla kontrol edildi.
Kimlik doğrulayıp hedefi seçin
CLI kurulu olsun. dosya upload --help kontrol edin. Profil → API anahtarları altında Yeni API anahtarı seçin. Listeleme/yükleme için Tam erişim seçin. Protokolde REST API izni verin. Gerekirse hedef çalışma alanıyla sınırlayın. Anahtar oluştur sonrasında tam anahtarı kaydedin.
dosya auth login
dosya workspace list
dosya workspace use ws_example
Gizli Enter API key: istemine erişim bilgisini girin. ws_example yerine liste yanıtındaki kimliği kullanın. Son komut varsayılanı kaydeder. Bunu atlayıp her yüklemede --workspace verebilirsiniz. Ortamdan gelen DOSYA_API_KEY kayıtlı anahtardan önceliklidir. CLI adlandırılmış hesap profilleri değil tek ayar dosyası tutar. Özel dosyaları aktarmadan hesabı ve alanı kontrol edin.
Üyelik yükleme ve gereken klasörleri oluşturma izni vermelidir. Yalnızca yükleme anahtarı listeleme/doğrulama yapamaz. Salt okunur anahtar yükleyemez. Tam erişimde de alan kuralları, anahtar sınırları, depolama hakkı ve klasör sınırı geçerlidir. Mevcut klasörü seçmek için kimliği dosya ls --workspace ws_example içinden alıp --folder fld_example verin. Klasör seçilen alanda ve erişiminiz içinde olmalıdır.
Yüklemeden önce yerel ağacı inceleyin
- İç içe klasörler özyinelemeli taranır.
.envve noktayla başlayanlar dahil gizli normal dosyalar yüklenir. Komutta yok sayma dosyası veya dışlama bayrağı yoktur. Gizli bilgi veya istenmeyen dosya varsa seçerek ayrı kaynak klasör hazırlayın. - İç içe sembolik bağlantı, soket ve aygıt girdileri atlanır. Normal çıktıda Skipping … non-regular file(s) görünür. Verilen üst yol normal dosya sistemi bilgisiyle çözümlenir. Hedefini izlemek istemiyorsanız kaynak olarak sembolik bağlantı kullanmayın.
- Yalnız kabul edilen dosyaların gerektirdiği klasörler oluşturulur. Boş alt klasör kopyalanmaz. Normal dosyasız ağaç Directory is empty. hatası verir.
- Aynı hedef klasördeki eşleşen mevcut adlar ikinci ayrı dosya değil yeni sürüm olur. Bu artımlı senkronizasyon karşılaştırması değil yüklemedir. Tekrar, değişmemiş dosyada bile sürüm oluşturabilir. Yalnız uzakta olan dosyalar silinmez.
Aktarım ve doğrulama bitene kadar kaynak dosyaları değiştirmeyin. Hedefte çalışma kopyaları varsa önce yeni deneme klasörü seçin.
Adımlar: klasör yüklemesini çalıştırın
dosya upload ./sample-source --recursive --workspace ws_example --parallel 3
Mevcut uzak klasörün altına koymak için:
dosya upload ./sample-source --recursive --workspace ws_example --folder fld_example
Ek sample-source düzeyini atlamak için:
dosya upload ./sample-source --recursive --contents --workspace ws_example --folder fld_example
Boşluklu yerel yolları tırnak içine alın. --recursive kısa biçimi -r, --workspace kısa biçimi -w olur. Dosya eşzamanlılığı varsayılan 3, en fazla 16 olur. --parallel veya -c ayarlar. CLI bunu daha düşük çalışma alanı oturum sınırına indirir. Tek çok parçalı dosyada bayrak paralel parçaları yönetir.
En fazla 5 MiB normal dosyalar, en fazla 200 dosya ve 48 MiB veri içeren isteklerde paketlenir. En fazla 4 grup paralel çalışır. Seçtiğiniz eşzamanlılık bunu da sınırlar. Grup kullanılamazsa tekil yüklemeye dönülür. 50 MiB üzeri, 10 MiB parçalarla sürdürülür. Son parça küçük olabilir. Bunlar aktarım eşikleridir. Her boyutta yükleme hakkı vermez. Uzantı, en büyük boyut, üye hakkı ve depolama yine reddedebilir.
CLI klasör oluşturmadan alan kurallarını okur. Normal çıktı en fazla 10 reddedilen yol gösterip kabul edilenlerle sürer. Atlanan kural ihlalleri tüm klasörün yüklendiğini kanıtlamaz. --json ile reddedilen dosya varsa files_rejected ve çıkış 2, klasör oluşmadan döner. Kota tahmini yetmezse uyarıp her dosyada kararı sunucuya bırakır. Bazıları çalışmayabilir.
Sonucu okuyup uzak ağacı doğrulayın
Normal çıktı önce dosya sayısı ve toplam boyutu bildirir. Etkileşimli ilerleme stderr üzerinden gider. Ardından Done. N uploaded, M failed. görünür. Betik dosya kimliği ve tekil sonuç istiyorsa JSON kullanın:
dosya upload ./sample-source --recursive --workspace ws_example --json > upload-result.json
Klasör sonucu uploaded, failed, failures ve files içerir. Başarılı girdide kimlik, ad, boyut ve sürüm bulunur. JSON yanında çıkış durumunu kontrol edin. Diğer dosyalar bitse de aktarım veya klasör oluşturma hatası çıkış 1 verir. Genel sınıflar 2 kullanım, 3 doğrulama, 4 ağ, 5 izin reddi ve 75 bakımdır. Başarı 0 olur.
Aynı çalışma alanında Dosyalar açıp kökü ve alt klasörleri inceleyin. Ad, boyut ve sayıları yerel ağaçla karşılaştırın. Örnek dosya indirip açın. Atlanan tüm yolları ve uyarıları inceleyin. Klasör oluşturma uyarısı alt dosyaları kalan üst klasöre yönlendirebilir. Yalnız başarı sayısı doğru yapıyı kanıtlamaz.
Kesinti, sürdürme ve güvenli yeniden deneme
Ctrl+C Interrupted. yazdırıp 130 ile çıkar. Tamamlanan dosya ve klasörler bulutta kalır. Kesinti işlemi geri almaz, bunları silmez.
Çok parçalı dosyada bayt göndermeden <local-file>.dosya-upload yazılır. Tamamlanınca kaldırılır. Aynı dosyanın sonraki yüklemesi boyut ve değiştirme zamanı eşleşiyorsa ve sürdürme adresleri ayarlı API sunucusuna aitse parçaları kullanabilir. Sürdürme kayıt dosyasını koruyun, düzenlemeyin. Tek akışlı yükleme geçici hatayı 1, 3 ve 8 saniye bekleyerek en fazla 3 kez dener. 4xx reddi geçici hata gibi tekrarlanmaz.
Kesilen klasörde eksik dosyaları özet ve hedef listesiyle bulun. Tek tek mevcut klasör kimliklerine yeniden yükleyin. Tüm ağacı körlemesine tekrarlamak başarılıları da yükler, ek sürüm oluşturabilir. Dosya taraması normal .dosya-upload sürdürme kayıt dosyalarını da içerir. Özyinelemeli tekrarı süzülmüş sürdürme saymayın. Eski oturum kullanılamıyorsa bilerek baştan başlatırken yalnız o dosyanın kaydını kaldırın. Yerel kayıt silinince buluttakiler etkilenmez.
Tam ret mesajını çözün
| Çıktı | Sonraki adım |
|---|---|
Use --recursive to upload a directory. | Kaynak ağacı kontrol edip --recursive ekleyin. |
Workspace ID required. | --workspace verin veya dosya workspace use ile varsayılan ayarlayın. |
Every file was refused by this workspace's upload rules. | Uzantı ve boyut sınırlarını inceleyin. Aynı girdiyi tekrarlamayın. |
--version-of can only be used with a single file. | Normal özyinelemeli yükleyin veya açık sürüm hedefiyle tek dosya değiştirin. |
Warning: failed to create folder | Sayıya güvenmeyi bırakın. Dosyaların yerini inceleyip tekrar denemeden klasör iznini veya hedefi düzeltin. |
--version-of tek dosyada vardır, klasörde yoktur. Mevcut dosyayı açıkça hedefler. Sürüm kurtarma çalışma alanı geçmiş saklamasıyla sınırlıdır. Doğrulama bitene kadar asıl yerel klasörü tutun.
Beklenen sonuç
Kabul edilen dosyalar hedefin altında beklenen göreli yollarda görünür. —contents kullandıysanız doğrudan hedefe konur. Sonuç yüklenenlerin yanında atlanan/reddedilen yolları ve kısmi hataları içerir. Klasör yüklemesini tamamlanmış saymadan sonucu inceleyin.
İlgili rehberler
Bu rehber yararlı oldu mu?
Değerlendirmeler yükleniyor…
Yanıtınızı değiştirebilmeniz için oy verdiğinizde gerekli bir oylama çerezi kaydedilir. Bu çerez en fazla 180 gün saklanır.
Sorular ve yanıtlar
Bu rehberdeki adımlar hakkında soru sorun. Sorular yayımlanmadan önce incelenir.
Herkese açık sorularda hesap bilgisi, erişim bilgisi veya özel dosya paylaşmayın. Bunlar için özel destek kanalını kullanın.
Sorular yükleniyor…
dosya.dev hesabınızda oturum açın ve sorunuzu sorun.