Object Storage Service:cp (Download objects)

API İşlemi

Açıklama

oss:GetObject

Bir nesneyi indirmek için gereklidir.

oss:GetObjectVersion

İsteğe bağlıdır. Kaynak nesnenin belirli bir sürümünü --version-id seçeneğiyle indirmek için gereklidir.

kms:GenerateDataKey

İsteğe bağlıdır. İndirilen nesne sunucu tarafında KMS kullanılarak şifrelenmişse gereklidir.

kms:Decrypt

oss:ListObjects

İsteğe bağlıdır. Toplu indirmeler (özyinelemeli işlemler) için gereklidir.

Parametre

Açıklama

cloud_url

OSS nesnesinin kaynak yolu. Biçim oss://bucket[/prefix] şeklindedir. Örneğin, oss://examplebucket/examplefile.txt.

file_url

Yerel dosyanın hedef yolu. Hedef bir dizinse yol bir ayraçla (/ veya \) bitmelidir. Örneğin, Linux yolu /localfolder/examplefile.txt, Windows yolu ise D:\localfolder\examplefile.txt şeklindedir.

-r, --recursive

İşlemi belirtilen ön ek altındaki tüm eşleşen nesnelere özyinelemeli olarak uygular. Aksi takdirde işlem yalnızca tek bir belirtilen nesneye uygulanır.

-f --force

Onay istemeden işlemi zorlar.

-u，--update

İndirmeyi yalnızca hedef dosya mevcut değilse veya kaynak nesnenin son değiştirilme zamanı hedef dosyanınkinden daha geçse gerçekleştirir.

--maxdownspeed

KB/sn cinsinden maksimum indirme hızı. Varsayılan değer 0'dır; bu, hız sınırı olmadığı anlamına gelir.

--disable-ignore-error

Toplu işlemler sırasında hataların yoksayılmasını devre dışı bırakır.

--only-current-dir

Yalnızca geçerli dizindeki nesneleri indirir ve alt dizinleri ile bunların içindeki nesneleri yoksayar.

--bigfile-threshold

Yeniden başlatılabilir indirme için bayt cinsinden boyut eşiği.

Varsayılan: 100 MB

Değer aralığı: 0 ile 9223372036854775807 arasında

--part-size

Bayt cinsinden parça boyutu. Varsayılan olarak ossutil, nesne boyutuna göre uygun bir parça boyutunu otomatik olarak hesaplar.

Değer aralığı: 1 ile 9223372036854775807 arasında

--checkpoint-dir

ossutil'in yeniden başlatılabilir indirme için kontrol noktası bilgilerini depoladığı dizin. Yeniden başlatılabilir bir indirme başarısız olursa ossutil kontrol noktası bilgilerini kaydetmek için bir .ossutil_checkpoint dizini oluşturur. ossutil, indirme başarılı olduktan sonra bu dizini siler. Belirtilen dizinin silinebilir olduğundan emin olun.

--range

Nesnenin belirtilen bayt aralığını indirir ve yeni bir dosya olarak kaydeder. Bayt numaralandırması sıfır tabanlıdır.

• Aralık belirtme

  Örneğin, 3-9 3. bayttan 9. bayta kadar olan baytları (dahil) indirir.

• Başlangıç konumu belirtme

  Örneğin, 3- 3. bayttan nesnenin sonuna kadar olan baytları (dahil) indirir.

• Bitiş konumu belirtme

  Örneğin, -9 0. bayttan 9. bayta kadar olan baytları (dahil) indirir.

--encoding-type

Nesne adının kodlama türü. Bu seçeneği url olarak ayarlayın. Bu seçenek belirtilmezse nesne adı kodlanmaz.

--include

Belirtilen desenle eşleşen tüm nesneleri dahil eder.

Daha fazla bilgi için bkz. include ve exclude seçenekleri.

--exclude

Belirtilen desenle eşleşen tüm nesneleri hariç tutar.

Daha fazla bilgi için bkz. include ve exclude seçenekleri.

--meta

Nesne için meta verileri ayarlar. Biçim header:value#header:value şeklindedir. Örnek: Cache-Control:no-cache#Content-Encoding:gzip. Meta veriler hakkında daha fazla bilgi için bkz. set-meta (Nesne meta verilerini yönetme).

--acl

Nesnenin erişim denetim listesi (ACL). Geçerli değerler:

• default (varsayılan): Nesne, paketin ACL'sini devralır.

• private: Yalnızca paket sahibi okuma ve yazma izinlerine sahiptir. Diğer kullanıcılar paketteki nesnelere erişemez.

• public-read: Yalnızca paket sahibi yazma izinlerine sahiptir. Anonim kullanıcılar dahil diğer tüm kullanıcıların paketteki nesneler üzerinde salt okunur izni vardır. Bu durum veri sızıntılarına ve artan ücretlere neden olabilir. Bu ACL'yi dikkatli kullanın.

• public-read-write: Anonim kullanıcılar dahil herkes paketteki nesneleri okuyup yazabilir. Bu durum veri sızıntılarına, artan ücretlere ve kötü amaçlı içerik yüklenmesi durumunda potansiyel yasal sorumluluklara neden olabilir. Özel kullanım durumları dışında genel okuma-yazma izinlerini yapılandırmayın.

--snapshot-path

İndirme sırasında anlık görüntü bilgilerinin kaydedildiği dizin. Bir sonraki indirmede ossutil, artımlı indirme yapmak için anlık görüntü bilgilerini bu dizinden okur.

--disable-crc64

64 bitlik döngüsel yedekleme denetimini (CRC-64) devre dışı bırakır. Varsayılan olarak ossutil, tüm veri aktarımları için CRC-64'ü etkinleştirir.

--payer

İstek için ödeme yöntemi. Belirtilen yola erişimden kaynaklanan trafik ve isteklerin talep eden tarafından ödenmesini sağlamak için bu seçeneği requester olarak ayarlayın.

--partition-download

İndirilecek nesnenin bir bölümünü belirtir. Değer Bölüm numarası:Toplam bölüm sayısı biçimindedir. Örneğin, 1:5 bu ossutil komutunun toplam 5 bölümden 1. bölümü indirdiğini gösterir. Bölüm numaraları 1 tabanlıdır. Aracın dahili algoritması, ossutil'in nesneyi nasıl böldüğünü belirler. Bu seçenek, bir nesneyi birden çok bölüme ayırmanıza ve birden çok ossutil komutu kullanarak paralel olarak indirmenize olanak tanır. Her komut atandığı bölümü indirir.

-j，--job

Çoklu nesne işlemleri için eşzamanlı görev sayısı. Varsayılan: 3. Değer aralığı: 1 ile 10.000 arasında.

--parallel

Tek nesne işlemleri için eşzamanlı görev sayısı. Değer aralığı: 1 ile 10.000 arasında. Bu seçenek ayarlanmazsa ossutil değeri işlem türüne ve nesne boyutuna göre belirler.

--version-id

Bir nesnenin belirli bir sürümünü indirir. --version-id seçeneğini yalnızca sürüm oluşturmanın etkin olduğu bir paketle birlikte kullanın. Bir paket için sürüm oluşturmayı etkinleştirmek üzere bkz. bucket-versioning (Sürüm Oluşturma).

--start-time

UNIX zaman damgası. Bu seçeneği belirtirseniz son değiştirilme zamanı bu zaman damgasından daha eski olan nesneler yoksayılır.

--end-time

UNIX zaman damgası. Bu seçeneği belirtirseniz son değiştirilme zamanı bu zaman damgasından daha geç olan nesneler yoksayılır.