Tüm Ürünler
Search
Belge Merkezi

:cp (download files)

Son Güncelleme:Oct 12, 2026

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:GetObject ve oss:ListObjects izinlerine sahip olmanız gerekir. Daha fazla bilgi için bkz. RAM kullanıcılarına özel izin ilkeleri atama.

  • -u, --update seç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 - değerini destekler. - olarak ayarlandığında çıktı standart çıkışa yönlendirilir.

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:

  • private: Özel.

  • public-read: Herkese açık okuma.

  • public-read-write: Herkese açık okuma ve yazma.

  • default: Paketten devral.

--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: .ossutil_checkpoint/).

--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:

  • none: kopyalama yapmaz.

  • metadata: meta verileri kopyalar.

  • default: hem meta verileri hem de etiketleri kopyalar.

-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: -f, --update, --size-only veya --ignore-existing.

--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:

  • COPY

  • REPLACE

--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

--min-age 1h yalnızca bir saat veya daha önce değiştirilen dosyaları indirir.

--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

--max-age 1h yalnızca son bir saat içinde değiştirilen dosyaları indirir.

--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

--min-mtime "2006-01-02T15:04:05" yalnızca 2 Ocak 2006 tarihinde UTC ile 15:04:05'ten sonra değiştirilen dosyaları indirir.

--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 ossutil_output/ dizininde atlanan dosyaları ve hata ayrıntılarını kaydeden bir hata raporu dosyası oluşturur.

--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:

  • Standard: Standart depolama.

  • IA: Seyrek Erişim depolama.

  • Archive: Arşiv Depolama.

  • ColdArchive: Soğuk Arşiv depolama.

  • DeepColdArchive: Derin Soğuk Arşiv depolama.

--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:

  • COPY

  • REPLACE

-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.

Not

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.

Not

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.

Not

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