OSS'deki dosya, görüntü veya video gibi kaynakları yerel makinenize indirmek için ossutil içindeki cp komutunu kullanın.
Notlar
Dosya indirmek için
oss:GetObjectveoss:ListObjectsizinlerine sahip olmanız gerekir. Daha fazla bilgi için bkz. RAM kullanıcılarına özel izin ilkeleri atama.-u, --updateseçeneğini kullandığınızda, hedef dosyanın var olup olmadığına bakılmaksızın sistem zaman damgalarını karşılaştırmak için her dosya için en az bir HEAD isteği gönderir. Verilerin nadiren değiştiği senaryolarda bu durum çok sayıda verimsiz istek oluşturur; bu da performansı düşürebilir ve ek istek ücretlerine yol açabilir. Gereksiz kaynak tüketimini önlemek amacıyla bu seçeneği kullanmadan önce iş ihtiyaçlarınızı değerlendirin.
Komut sözdizimi
ossutil cp oss://bucket[/prefix] local-path [flags]
|
Parametre |
Tür |
Açıklama |
|
local-path |
string |
Göreli yolları, mutlak yolları ve |
|
prefix |
string |
Nesne öneki. Önek "/" ile biterse yalnızca toplu işlemler desteklenir. "/" ile bitmiyorsa komut, komut satırı seçeneklerine göre tek nesne mi yoksa toplu indirme mi yapılacağını belirler. |
|
--acl |
string |
Nesne için erişim izinleri. Geçerli değerler:
|
|
--bandwidth-limit |
SizeSuffix |
Veri aktarım hızını kontrol etmek amacıyla ağ bant genişliğini sınırlar. Minimum değer 1024 B/s'dir. Varsayılan birim B/s'dir. Bant genişliği değeri için bir birim belirtebilirsiniz. Desteklenen birimler şunlardır: B (bayt), K (kilobayt), M (megabayt) ve G (gigabayt). Örneğin, 50 M limiti 50 MB/s olarak ayarlar. |
|
--bigfile-threshold |
SizeSuffix |
Büyük dosyalar için çok parçalı yükleme, indirme veya kopyalama özelliğinin etkinleştirilme eşiği (varsayılan: 104857600). |
|
--cache-control |
string |
Nesne bir web tarayıcısı tarafından indirildiğinde önbellekleme davranışını belirtir. |
|
--checkers |
int |
Eşzamanlı denetleyici sayısı (varsayılan: 16). |
|
--checkpoint-dir |
string |
Kaldığı yerden devam eden indirmeler için kontrol noktası bilgilerinin depolandığı dizin (varsayılan: |
|
--content-disposition |
string |
Nesnenin nasıl görüntüleneceğini belirtir. |
|
--content-encoding |
string |
Nesnenin kodlama yöntemini bildirir. |
|
--content-type |
string |
Nesnenin içerik türü. |
|
--copy-props |
string |
Meta verilerin ve etiketlerin nasıl kopyalanacağını kontrol eder. Geçerli değerler:
|
|
-d, --dirs |
string |
Geçişli olarak iç içe geçmiş alt dizinlerdeki tüm dosyaları indirmeden, geçerli dizindeki dosyaları ve alt dizinleri indirir. |
|
--encoding-type |
string |
Giriş nesne adları veya dosya adları için kodlama yöntemi. Geçerli değer: url. |
|
--end-with |
string |
Alfabetik sıraya göre belirtilen değerden önce gelen veya bu değerle eşleşen nesneleri döndürür. |
|
--exclude |
stringArray |
Yollar veya dosya adları için dışlama kuralları. |
|
--exclude-from |
stringArray |
Dışlama kurallarını bir dosyadan okur. |
|
--expires |
string |
Önbelleğe alınmış içerik için mutlak sona erme zamanını belirtir. |
|
--files-from |
stringArray |
Boş veya açıklama satırlarını yoksayarak kaynak dosya adlarının listesini bir dosyadan okur. Yalnızca filtreleme senaryolarında uygulanır. |
|
--files-from-raw |
stringArray |
Kaynak dosya adlarının listesini bir dosyadan okur. Yalnızca filtreleme senaryolarında uygulanır. |
|
--filter |
stringArray |
Yollar veya dosya adları için filtreleme kuralları. |
|
--filter-from |
stringArray |
Filtreleme kurallarını bir dosyadan okur. |
|
-f, --force |
/ |
Onay istemeden işlemi zorla. |
|
--include |
stringArray |
Yollar veya dosya adları için dahil etme kuralları. |
|
--include-from |
stringArray |
Dahil etme kurallarını bir dosyadan okur. |
|
-j, --job |
int |
Eşzamanlı görev sayısı (varsayılan: 3). Not
Bu parametre yalnızca aşağıdakilerden herhangi birini de belirttiğinizde etkili olur: |
|
--list-objects |
/ |
Nesneleri listelemek için ListObjects API'sini kullanır. |
|
--max-size |
SizeSuffix |
Aktarılacak maksimum dosya boyutu. Varsayılan birim bayttır. Bir son ek ekleyebilirsiniz: B|K|M|G|T|P. Not: 1K (KiB) = 1024B. |
|
--metadata |
strings |
Anahtar=değer biçiminde, nesne için kullanıcı tanımlı meta veriler. |
|
--metadata-directive |
string |
Hedef nesne için meta verilerin nasıl ayarlanacağını belirtir. Geçerli değerler:
|
|
--metadata-exclude |
stringArray |
Nesne meta verileri için dışlama kuralları. |
|
--metadata-filter |
stringArray |
Nesne meta verileri için filtreleme kuralları. |
|
--metadata-filter-from |
stringArray |
Nesne meta verisi filtreleme kurallarını bir dosyadan okur. |
|
--metadata-include |
stringArray |
Nesne meta verileri için dahil etme kuralları. |
|
--min-age |
Süre |
Yalnızca belirtilen zaman aralığından önce değiştirilen dosyaları indirir. Varsayılan birim saniyedir. h (saat) gibi son ekler kullanabilirsiniz. Örneğin, 1h 1 saat anlamına gelir. Not
|
|
--max-age |
Süre |
Yalnızca belirtilen zaman aralığı içinde değiştirilen dosyaları indirir. Varsayılan birim saniyedir. h (saat) gibi son ekler kullanabilirsiniz. Örneğin, 1h 1 saat anlamına gelir. Not
|
|
--min-mtime |
Zaman |
Yalnızca belirtilen zamandan sonra değiştirilen dosyaları indirir. Zaman biçimi: UTC, örneğin 2006-01-02T15:04:05. Not
|
|
--max-mtime |
Zaman |
Yalnızca belirtilen zamandan önce değiştirilen dosyaları indirir. Zaman biçimi: UTC, örneğin 2006-01-02T15:04:05. |
|
--min-size |
SizeSuffix |
Aktarılacak minimum dosya boyutu. Varsayılan birim bayttır. Bir son ek ekleyebilirsiniz: B|K|M|G|T|P. Not: 1K (KiB) = 1024B. |
|
--no-error-report |
/ |
Hata raporu dosyasının oluşturulmasını devre dışı bırakır. Toplu bir işlem sırasında hatalarla karşılaşıldığında ossutil, varsayılan olarak |
|
--no-progress |
/ |
İlerleme çubuğunu göstermez. |
|
--page-size |
int |
Toplu indirme sırasında sayfa başına listelenen maksimum nesne sayısı (varsayılan: 1000). Geçerli aralık: 1–1000. |
|
--parallel |
int |
Tek bir dosyadaki dahili işlemler için eşzamanlı görev sayısı. |
|
--part-size |
SizeSuffix |
Çok parçalı işlemler için parça boyutu. Varsayılan olarak ossutil, dosya boyutuna göre uygun bir parça boyutu hesaplar. Geçerli aralık: 100 KiB–5 GiB. |
|
-r, --recursive |
/ |
İşlemleri geçişli olarak gerçekleştirir. Bu seçenek belirtildiğinde komut, paketteki tüm eşleşen nesneler üzerinde çalışır. Aksi takdirde yalnızca yol tarafından belirtilen nesne üzerinde çalışır. |
|
--request-payer |
string |
İstek için ödeme yöntemi. Paket istek başına ödeme modunu kullanıyorsa bunu requester olarak ayarlayın. |
|
--size-only |
/ |
Yalnızca boyutları hedef dosyalardan farklı olan kaynak dosyaları indirir. |
|
--start-after |
string |
Alfabetik sıraya göre belirtilen değerden sonra gelen nesneleri döndürür; değer kendisi hariç tutulur. |
|
--storage-class |
string |
Nesnenin depolama sınıfı. Geçerli değerler:
|
|
--tagging |
strings |
Anahtar=değer biçiminde nesne için etiketler. |
|
--tagging-directive |
string |
Hedef nesne için etiketlerin nasıl ayarlanacağını belirtir. Geçerli değerler:
|
|
-u, --update |
/ |
Hedefte zaten mevcut olan ve kaynak dosyalara göre daha yeni bir değiştirilme zamanına sahip dosyaları atlar. Not
Bir dosya hedefte zaten mevcutsa ancak kaynak dosyaya kıyasla daha eski bir değiştirilme zamanına sahipse güncellenir. |
|
--ignore-existing |
/ |
Hedefte zaten mevcut olan dosyaları atlar. |
|
--version-id |
string |
Nesnenin sürüm kimliği. |
|
--write-buffer-size |
SizeSuffix |
Yazma işlemleri için kullanılan bellek arabelleğinin boyutu. Otomatik olarak 4 KB sınırlarına hizalanır. B / K / M son eklerini destekler (varsayılan: 128 KiB). Geçerli aralık: 0–32 MiB. |
ossutil 2.3.0 sürümünden itibaren --job, --parallel, --bigfile-threshold, --part-size ve --write-buffer-size seçenekleri bir yapılandırma dosyasında ayarlanabilir. Bunları ilgili profil bölümüne key=value biçiminde (örneğin job=10) ekleyin veya yazmak için ossutil config set komutunu kullanın. Komut satırı seçenekleri, yapılandırma dosyası ayarlarına göre önceliklidir.
Desteklenen genel komut satırı seçenekleri için bkz. Genel komut satırı seçenekleri.
Hedef dosyaların adlandırma kuralları aşağıdaki gibidir:
Tek dosya indirmelerinde hedef bir dizinse dosya, kaynak dosyanın göreli yolu kullanılarak bu dizinde oluşturulur.
Tek dosya indirmelerinde hedef bir dosyaysa veya mevcut değilse belirtilen hedef dosya adı kullanılır.
Toplu indirmelerde, kaynak dosyaların göreli yollarına göre alt dizinler hedef kök dizin altında seviye seviye oluşturulur ve ardından dosyalar oluşturulur.
Kaynak dosyanın göreli yolu, önekteki son '/' karakterine kadar olan tüm karakterlerin (bu karakter dahil) kaldırılmasıyla elde edilir.
Örneğin, cp oss://bucket/root/dir/ ... komutunda root/dir/subdir/test.txt nesnesinin göreli yolu subdir/test.txt şeklindedir.
Hata işleme
Toplu indirme sırasında ossutil, geri yüklenmemiş arşiv dosyaları veya ihlal nedeniyle dondurulmuş dosyalar gibi indirilemeyen dosyalarla karşılaşırsa bu dosyaları varsayılan olarak atlar ve kalan dosyaları indirmeye devam eder.
Atlanan dosyalar ve bunların hata ayrıntıları ossutil_output/ dizinindeki bir hata raporu dosyasına kaydedilir. Bu rapor dosyasının oluşturulmasını devre dışı bırakmak için --no-error-report seçeneğini kullanın. Bu seçenek atlama davranışını etkilemez.
Çıkış kodları:
0: Tüm dosyalar başarıyla indirildi.2: Tek dosya işlemi başarısız oldu. Örneğin, geri yüklenmemiş bir arşiv dosyasını indirmek HTTP 403 hatası döndürür; bu, nesnenin mevcut durumunda indirilebilir olmadığını gösterir.4: Toplu işlem tamamlandı ancak bazı dosyalar indirilemedi.
Örnekler
Tek dosya indirme
İndirme sırasında bir dosya adı belirtmezseniz orijinal dosya adı yerel olarak kullanılır. Bir dosya adı belirtirseniz dosya yerel olarak bu adla kaydedilir.
-
Orijinal dosya adını kullanarak kaydetme
ossutil cp oss://examplebucket/examplefile.txt D:/localpath -
Belirtilen bir dosya adını kullanarak kaydetme
ossutil cp oss://examplebucket/examplefile.txt D:/localpath/example.txt
Birden çok dosya indirme
-
Belirli bir türdeki dosyaları indirme
Ortak bir önek veya son ek gibi aynı adlandırma desenini paylaşan birden çok dosyayı indirmek için eşleşen dosyaları seçmek üzere --include ve --exclude seçeneklerini kullanın.
JPG formatındaki dosyalar hariç tüm dosyaları indirin:
ossutil cp oss://examplebucket/destfolder/ D:/localpath/ --exclude "*.jpg" -r -
Klasörü indirme
ossutil cp -r oss://examplebucket/destfolder/ D:/localpath/ -
Paket kökündeki tüm dosyaları indirme
ossutil cp -r oss://examplebucket D:/localpath/
İndirme hızını sınırlama
examplefile.txt dosyasını geçerli dizine indirin ve indirme hızını 20 MB/s ile sınırlayın.
ossutil cp oss://examplebucket/examplefile.txt . --bandwidth-limit 20971520