Desteklenen tüm komut satırı seçeneklerini listelemek için ossutil -h komutunu çalıştırın.
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:
|
|
--proxy-host, --proxy-user, --proxy-pwd |
Proxy yapılandırma seçenekleri:
Yapılandırmadan sonra ossutil trafiği proxy üzerinden yönlendirir.
|
|
--mode |
Kimlik bilgilerinin türü. Geçerli değerler:
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, RamRoleArn modunda varsayılan STS uç noktası: |
|
--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.
|
|
--all-versions |
Bir nesnenin tüm sürümlerini belirtir. |
|
--type |
Veri doğrulama yöntemi. Geçerli değerler:
|
|
-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:
|
|
--sse-algorithm |
Paket için sunucu taraflı şifreleme algoritması. Geçerli değerler:
|
|
--include |
Belirtilen koşulları karşılayan nesneleri listeler. Örneğin, |
|
--exclude |
Belirtilen koşulları karşılamayan nesneleri listeler. Örneğin, |
|
-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: |
|
--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: |
|
--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:
|
|
--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 |
|
--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.
|
|
--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:
|
|
-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: |
|
--bucketname |
Paket adı. |
|
--encoding-type |
|
|
--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, |
|
--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:
|
|
--redundancy-type |
Paketin veri yedeklilik türü. Geçerli değerler:
|
|
--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: |
|
--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.