Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:View options

Son Güncelleme:Oct 01, 2026

Desteklenen tüm komut satırı seçeneklerini listelemek için ossutil -h komutunu çalıştırın.

Not

ossutil V1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak ossutil kullanabilirsiniz. İşletim sisteminize göre ikili dosya adını değiştirmeniz gerekmez. 1.6.16'dan önceki bir ossutil sürümü kullanıyorsanız, ikili dosya adını işletim sisteminize uyacak şekilde değiştirmelisiniz. Daha fazla bilgi için bkz. ossutil için komut referansı.

Komut formatı

ossutil -h

Belirli bir komutun seçeneklerini görüntülemek için ossutil help [komut] komutunu çalıştırın; örneğin, ossutil help cp.

Yaygın seçenekler

Çoğu ossutil komutu aşağıdaki seçenekleri destekler:

Seçenek

Açıklama

-c, --config-file

Başlangıçta okunan ossutil yapılandırma dosyasının yolu. Birden çok hesapta paketleri yönetmek için ayrı yapılandırma dosyaları oluşturun ve kullanılacak olanı belirtmek üzere -c seçeneğini kullanın.

-e, --endpoint

Paketin uç noktası. Birden çok bölgede paketleri yönetmek için ilgili uç noktayı belirtin. Bölgeler ve Uç Noktalar.

-i, --access-key-id

OSS erişimi için AccessKey kimliği. Birden çok hesapta paketleri yönetirken bu seçeneği belirtin.

-k, --access-key-secret

OSS erişimi için AccessKey gizli anahtarı. Birden çok hesapta paketleri yönetirken bu seçeneği belirtin.

-p, --password

AccessKey gizli anahtarını klavyeden girmenizi ister. Girilen değer, başka yerlerde yapılandırılan tüm AccessKey gizli anahtarlarını geçersiz kılar.

--loglevel

Geçerli çalışma dizininde bir ossutil.log dosyası oluşturur. Varsayılan olarak günlük dosyası oluşturmaz.

Geçerli değerler:

  • info: ossutil işlem kayıtlarını günlüğe kaydeder.

    ossutil [command] --loglevel=info
  • debug: Sorun giderme amacıyla HTTP akış günlüklerini ve orijinal imza dizesini çıktılar.

    ossutil [command] --loglevel=debug

--proxy-host, --proxy-user, --proxy-pwd

Proxy yapılandırma seçenekleri:

  • --proxy-host: Proxy sunucusunun URL'si. HTTP, HTTPS ve SOCKS5 desteklenir.

  • --proxy-user: Proxy sunucusu için kullanıcı adı. Varsayılan değer boştur.

  • --proxy-pwd: Proxy sunucusu için parola. Varsayılan değer boştur.

Yapılandırmadan sonra ossutil trafiği proxy üzerinden yönlendirir.

ossutil ls oss://bucket1 --proxy-host http://47.88.**.**:3128 --proxy-user test --proxy-pwd test

--mode

Kimlik bilgilerinin türü. Geçerli değerler:

  • AK: Bir AccessKey kimliği ve AccessKey gizli anahtarı kullanarak OSS'e erişin.

  • StsToken: Güvenlik Belirteci Hizmeti (STS) belirteci kullanarak OSS'e erişin.

  • RamRoleArn: RAM kullanıcısının AssumeRole işlemini kullanarak OSS'e erişin.

  • EcsRamRole: ECS örneği için bir RAM rolü kullanarak ECS örneğinde parolasız erişim sağlar.

Atlanırsa varsayılan kimlik doğrulama mantığı uygulanır.

--ecs-role-name

EcsRamRole kimlik doğrulama modundaki RAM rolünün adı.

--token-timeout

RamRoleArn modundaki geçici erişim kimlik bilgilerinin geçerlilik süresi. Birim: saniye. Varsayılan: 3600.

--ram-role-arn

RamRoleArn kimlik doğrulama modundaki RAM rolünün Alibaba Cloud Kaynak Adı (ARN).

--role-session-name

RamRoleArn kimlik doğrulama modundaki oturum adı.

--read-timeout

İstemci okuma zaman aşımı. Birim: saniye. Varsayılan: 1200.

--connect-timeout

İstemci bağlantı zaman aşımı. Birim: saniye. Varsayılan: 120.

--sts-region

STS hizmet bölgesi; örneğin, cn-hangzhou. Desteklenen bölgeler Uç Noktalar bölümünde listelenmiştir.

RamRoleArn modunda varsayılan STS uç noktası: sts.aliyuncs.com.

--skip-verify-cert

Sunucu tarafındaki dijital sertifikanın doğrulanmasını atlar.

--ua

User-Agent HTTP istek üst bilgisine özel bir değer ekler. Günlüklerde tam User-Agent değerini görüntülemek için --loglevel debug ile birlikte kullanın.

Diğer seçenekler

ossutil komutları ayrıca aşağıdaki seçenekleri de destekler:

Seçenek Adı

Açıklama

-s, --short-format

Sonuçları kısa formatta görüntüler. Varsayılan: uzun format.

--bigfile-threshold

Kademeli yükleme için dosya boyutu eşiği. Birim: bayt. Varsayılan: 100 MB. Aralık: 0 ila 9223372036854775807.

--acl

Erişim kontrol listesini (ACL) yapılandırır.

--range

Bir dosyadan indirilecek sıfır tabanlı bayt aralığını belirtir.

  • Bir aralık belirtebilirsiniz. Örneğin, 3-9, 3. bayttan 9. bayta kadar (dahil) olan aralığı ifade eder.

  • Başlangıç noktası belirtebilirsiniz; örneğin, 3-, 3. bayttan dosyanın sonuna kadar (dahil) indirme yapar.

  • Bitiş konumunu belirtebilirsiniz. Örneğin, -9, 0. bayttan 9. bayta kadar olan aralığı belirtir.

--all-versions

Bir nesnenin tüm sürümlerini belirtir.

--type

Veri doğrulama yöntemi. Geçerli değerler:

  • crc64 (varsayılan): 64 bitlik döngüsel yinelenen artıklık denetimi (CRC64) gerçekleştirir.

  • md5: MD5 doğrulaması gerçekleştirir.

-v, --version

ossutil sürümünü görüntüler ve çıkar.

-u, --update

Güncelleme işlemi gerçekleştirir.

--origin

HTTP istek üst bilgisindeki origin alanının değeri.

--upmode

probe komutunda kullanılan yükleme modu. Geçerli değerler:

  • normal (varsayılan): Basit yükleme.

  • append: Ekleme yoluyla yükleme.

  • multipart: Çok parçalı yükleme.

--sse-algorithm

Paket için sunucu taraflı şifreleme algoritması. Geçerli değerler:

  • KMS: Şifreleme ve şifre çözme için Key Management Service (KMS) tarafından yönetilen bir anahtar kullanır; bu SSE-KMS'dir.

  • AES256: Şifreleme ve şifre çözme için OSS tarafından yönetilen bir anahtar kullanır; bu SSE-OSS'tir.

--include

Belirtilen koşulları karşılayan nesneleri listeler. Örneğin, *.jpg JPG formatındaki tüm dosyaları listeler.

--include ve --exclude seçenekleri.

--exclude

Belirtilen koşulları karşılamayan nesneleri listeler. Örneğin, *.txt TXT formatında olmayan tüm dosyaları listeler.

--include ve --exclude seçenekleri.

-r, --recursive

Paketteki eşleşen tüm nesneler üzerinde yinelemeli olarak işlem yapar. Bu seçenek olmadan yalnızca belirtilen nesne etkilenir.

--addr

Ping aracılığıyla bağlantı testi için bir ağ adresi belirtir.

Varsayılan değer: www.aliyun.com

--kms-masterkey-id

KMS'deki müşteri ana anahtarının (CMK) kimliği.

--version-id

Nesnenin sürüm kimliği.

--version-id-marker

Alfabetik olarak belirtilen işaretçiden sonra gelen kimliklere sahip nesne sürümlerini listeler. Sürüm oluşturmanın etkinleştirilmesini gerektirir.

-m, --multipart

İşlemin paketteki tamamlanmamış çok parçalı yükleme olaylarına uygulanacağını belirtir.

-d, --directory

Yalnızca geçerli dizindeki dosyaları ve alt dizinleri döndürür.

--payer

İstek sahibi. İstekte bulunan öder modu için requester olarak ayarlayın.

--maxupspeed

Maksimum yükleme hızı. Birim: KB/s. Varsayılan: 0 (sınır yok).

--maxdownspeed

Maksimum indirme hızı. Birim: KB/s. Varsayılan: 0 (sınır yok).

--retry-times

Hata sonrası yeniden deneme sayısı. Varsayılan: 10. Aralık: 1 ila 500.

Not

Yeniden denemeler hatadan hemen sonra gerçekleşir.

--download

Dosya URL'sini kullanarak hedef paketten bir nesne indirerek ağ bağlantısını test eder.

-j, --jobs

Çoklu dosya işlemleri için eşzamanlı görev sayısı. Varsayılan: 3. Aralık: 1 ila 10000.

-a, --all-type

İşlemin paketteki nesnelere ve tamamlanmamış çok parçalı yükleme olaylarına uygulanacağını belirtir.

--disable-empty-referer

Referer alanının boş olamayacağını belirtir.

--method

HTTP istek yöntemi. Geçerli değerler arasında PUT, GET ve DELETE bulunur.

--output-dir

Rapor dosyalarının çıktı dizini; örneğin, cp komutundan gelen toplu kopyalama hata raporları.

Varsayılan: Geçerli dizindeki ossutil_output dizini.

--meta

Nesne meta verilerini ayarlar. Format: Cache-Control:no-cache#Content-Encoding:gzip.

--object

probe komutunda dosya adını belirtir.

--end-time

UNIX zaman damgası. Bu seçeneği kullanırsanız, belirtilen zamandan sonra son değiştirilen nesneler yok sayılır.

--limited-num

Döndürülecek maksimum sonuç sayısı.

-L, --language

ossutil için dili ayarlar. Geçerli değerler:

  • CH (varsayılan): Çince. Dili CH olarak ayarlarsanız sistem kodlamanızın UTF-8 olduğundan emin olun.

  • EN: İngilizce.

--delete

Bir paketi, nesneyi veya parçayı siler.

-b, --bucket

Bu seçeneği yalnızca bir paketi silerken kullanın.

--disable-crc64

CRC64 doğrulamasını devre dışı bırakır. Varsayılan olarak ossutil veri aktarımı için CRC64 doğrulamasını etkinleştirir.

--upload

Yerel bir dosyayı hedef pakete yükleyerek ağ bağlantısını test eder.

--part-size

Parça boyutu. Birim: bayt. Varsayılan olarak ossutil parça boyutunu dosya boyutuna göre hesaplar. Aralık: 1 ila 9223372036854775807.

--timeout

İmzalı URL zaman aşımı. Birim: saniye. Varsayılan: 60. Aralık: 0 ila 9223372036854775807.

--checkpoint-dir

Kademeli yükleme/indirme kontrol noktası verileri için dizin. Başarısızlık durumunda ossutil bir .ossutil_checkpoint dizini oluşturur; bu dizin işlem başarılı olduktan sonra silinir. Belirtilen dizinin silinebilir olduğundan emin olun.

--url

Dosya URL'si.

--marker

Adları alfabetik olarak belirtilen işaretçiden sonra gelen paketleri, nesneleri veya parçaları listeler.

-f, --force

Onay istemi olmadan işlemi zorla gerçekleştirir.

--snapshot-path

Artımlı yüklemeler ve indirmeler için kullanılan anlık görüntü verilerinin dizini.

  • --snapshot-path, işlemler arasında ilgili OSS nesnelerini başka bir kullanıcı değiştirmediğinde büyük dosya kümelerinin artımlı aktarımını hızlandırır. Kopyalama işlemleri için desteklenmez.

  • --snapshot-path, başarıyla aktarılan dosyaların lastModifiedTime değerini kaydeder ve sonraki çalıştırmalarda değişmemiş dosyaları atlar. Diğer kullanıcıların OSS nesnelerini değiştirebileceği durumlarda bunun yerine --update kullanın.

  • Anlık görüntü verileri otomatik olarak silinmez. Artık gerekli olmadığında anlık görüntü yolunu temizleyin.

  • Bu seçenek G/Ç ek yükü ekler. Küçük dosya kümeleri veya paylaşılan nesneler için bunun yerine --update kullanın.

  • --update ve --snapshot-path birlikte kullanılabilir. ossutil önce anlık görüntüyü kontrol eder, ardından --update seçeneğine geri döner.

--start-time

UNIX zaman damgası. Bu seçeneği kullanırsanız, belirtilen zamandan önce son değiştirilen nesneler yok sayılır.

--storage-class

Depolama sınıfı. Geçerli değerler:

  • Standard (varsayılan): Sık erişilen veriler içindir.

  • IA: Seyrek Erişim. Ayda bir veya iki kez erişilen veriler içindir. Minimum depolama süresi: 30 gün. Minimum faturalandırılabilir boyut: 64 KB. Veri alma ücretleriyle gerçek zamanlı erişim sağlar.

  • Archive: Uzun vadeli veri arşivleme. Minimum depolama süresi: 60 gün. Minimum faturalandırılabilir boyut: 64 KB. Erişimden önce geri yükleme gerekir (~1 dakika). Veri alma ücretleri uygulanır.

  • ColdArchive: Uzun vadeli depolama gerektiren son derece soğuk veriler. Minimum depolama süresi: 180 gün. Minimum faturalandırılabilir boyut: 64 KB. Erişimden önce geri yükleme gerekir; süre veri boyutuna ve geri yükleme moduna göre değişir. Veri alma ücretleri uygulanır.

-t, --sts-token

Geçici kimlik bilgisi erişimi için STS belirteci. Yalnızca STS kimlik bilgileriyle gerektiğinde kullanılır ve yapılandırma dosyası ayarını geçersiz kılar. Geçici erişim kimlik bilgileri.

--parallel

Tek dosya işlemleri için eşzamanlı görev sayısı. Aralık: 1 ila 10000. Varsayılan: İşlem türüne ve dosya boyutuna göre belirlenir.

--partition-download

Paralel indirmeler için bir bölüm belirtir. Format: partition_number:total_partitions. Örneğin, 1:5 toplam 5 bölümden 1. bölümü indirir. Bölüm numaraları 1 tabanlıdır. Birden fazla ossutil örneği farklı bölümleri paralel olarak indirebilir.

--bucketname

Paket adı.

--encoding-type

oss://bucket_name sonrasında nesne anahtarını URL kodlar. Geçerli değer: url. Atlanırsa anahtar kodlanmaz.

--origin

Kaynak kökenli istekleri tanımlamak için kullanılan Origin HTTP istek üst bilgisi değeri.

--acr-method

Access-Control-Request-Method HTTP istek üst bilgisinin değeri. Geçerli değerler GET, PUT, POST, DELETE ve HEAD'dir.

--acr-headers

CORS ön uçuş istekleri için Access-Control-Request-Headers değeri. Birden çok üst bilgiyi virgülle ayırın ve çift tırnak içine alın; örneğin, --acr-headers "header1,header2,header3".

--upload-id-marker

Yükleme kimlikleri alfabetik olarak belirtilen işaretçiden sonra gelen parçaları listeler.

-h, --help

Yardım bilgilerini görüntüler.

--trafic-limit

sign komutu için HTTP hız sınırı. Birim: bit/s.

Varsayılan: 0 (sınır yok).

Aralık: 819200 ila 838860800 (100 KB/s ila 100 MB/s).

--local-host

cp komutunda OSS erişimi için yerel IP adresi.

--enable-symlink-dir

Bağlantılı alt dizinleri yükler (varsayılan olarak atlanır). Döngüsel sembolik bağlantıları algılamak için probe komutunu kullanın.

--only-current-dir

Alt dizinleri yok sayarak yalnızca geçerli dizindeki dosyaları işler.

--disable-dir-object

Yükleme sırasında dizin nesneleri oluşturmayı atlar. Dizin yapısı konsolda görünür durumda kalır ancak içindeki tüm dosyalar silindiğinde kaybolur.

--probe-item

Test hedefi. Geçerli değerler:

  • upload-speed: Yükleme bant genişliğini test eder.

  • download-speed: İndirme bant genişliğini test eder.

  • cycle-symlink: Yerel dosya dizininde sonsuz döngü bağlantılı dosya veya dizin olup olmadığını test eder.

--redundancy-type

Paketin veri yedeklilik türü. Geçerli değerler:

  • LRS (varsayılan): Yerel olarak yedekli depolama (LRS), verilerinizi aynı alandaki farklı depolama cihazlarında yedekli olarak saklar. İki depolama cihazı eşzamanlı olarak hasar gördüğünde bile veri dayanıklılığını ve kullanılabilirliğini sağlar.

  • ZRS: Alan yedekli depolama (ZRS) verilerinizi aynı bölgedeki birden çok alanda yedekli olarak depolamak için çok alanlı veri yedekliliği mekanizması kullanır. Bir alan kullanılamaz hale gelse bile veri kullanılabilirliğini sağlar.

--disable-encode-slash

URL'deki eğik çizgiyi (/) kodlamaz.

--disable-all-symlink

Yükleme sırasında tüm sembolik bağlantılı alt dosyaları ve sembolik bağlantılı alt dizinleri yok sayar.

--tagging

Yükleme veya kopyalama sırasında nesne etiketlerini ayarlar. Format: "abc=1&bcd=2&...".

--disable-ignore-error

Toplu işlemlere devam etmek yerine hatada hemen sonlandırır.

--block-size

Çıktıda nesne boyutları için birim. Geçerli değerler: KB, MB, GB veya TB. Varsayılan: bayt.

Önemli

Bu seçenek yalnızca ossutil 1.7.3 ve sonraki sürümlerde mevcuttur.

--include ve --exclude seçenekleri

Birden çok seçenek için kural uygulaması

Kurallar birden çok include ve exclude koşulu içerebilir; bu koşullar soldan sağa doğru değerlendirilir. Örneğin, test.txt adlı bir dosya verildiğinde:

  • Kural 1: --include "*test*" --exclude "*.txt" . --include "*test*" kuralı test.txt dosyasıyla eşleşir. Ardından --exclude "*.txt" kuralı uygulanır. Dosya adı test.txt .txt içerdiğinden dosya hariç tutulur. Sonuç olarak test.txt hariç tutulur.

  • Kural 2: --exclude "*.txt" --include "*test*". --exclude "*.txt" kuralı test.txt dosyasını hariç tutar. Ardından --include "*test*" kuralı uygulanır. Dosya adı test içerdiğinden test.txt dahil edilir. Sonuç olarak test.txt dahil edilir.

  • Kural 3: --include "*test*" --exclude "*.txt" --include "te?t.txt" . Kural --include "*test*" ile eşleştiğinde test.txt dahil edilir. Kural --exclude "*.txt" ile eşleşmeye devam ettiğinde, adı .txt içerdiğinden test.txt hariç tutulur. Kural sonunda --include "te?t.txt" ile eşleştiğinde test.txt dahil edilir. Sonuç olarak test.txt dahil edilir.

Desteklenen formatlar

  • Yıldız işareti (*) joker karakteri: Herhangi bir karakter dizisini eşleştirir. Örneğin, *.txt TXT formatındaki tüm dosyalarla eşleşir.

  • Soru işareti (?) joker karakteri: Herhangi bir tek karakteri eşleştirir. Örneğin, abc?.jpg adları abc ve ardından herhangi bir tek karakterden oluşan tüm JPG dosyalarıyla eşleşir; örneğin, abc1.jpg.

  • [dizi]: Dizideki herhangi bir karakterle eşleşir. Örneğin, abc[1-5].jpg abc1.jpg ile abc5.jpg arasındaki dosyalarla eşleşir.

  • [!dizi]: Dizide olmayan herhangi bir karakterle eşleşir. Örneğin, abc[!0-7].jpg abc0.jpg ile abc7.jpg dışındaki dosyalarla eşleşir.

Sınırlamalar

Koşullarda dizin formatları desteklenmez. Örneğin, ossutil cp oss://examplebucket/destfolder/ localfolder/ --include dir/ komutunu çalıştırırsanız --include or --exclude does not support format containing dir info hatası bildirilir.