Download and install the command-line tool ossutil - Object Storage Service

ossutil, büyük dosyaları hızlıca yüklemek, dosya indirmek ve belirli bir öneke sahip dosyaları silmek için kullanabileceğiniz bir komut satırı aracıdır. ossutil; Windows, Linux ve macOS gibi işletim sistemlerinde çalışır. Ortamınıza uygun sürümü indirip yükleyebilirsiniz.

Yeni sürüm mevcut

Yükseltilmiş ossutil 2,0 sürümünü kullanmanızı öneririz. Hızlı kurulum ve kullanım hakkında daha fazla bilgi için bkz. ossutil'i yükleyin. ossutil 1,0 artık güncellenmemektedir. Yeni özellikler ve iyileştirmeler yalnızca ossutil 2,0'da sunulmaktadır.

ossutil 2,0'ın temel özellikleri:

Yeni komut yapısı: ossutil api put-bucket-acl gibi API düzeyindeki komutları ve ossutil config gibi üst düzey komutları içeren çok düzeyli komutları destekler.
Geliştirilmiş yapılandırma yönetimi: İlk yapılandırma süreci basitleştirilmiştir. Kurulumdan sonra temel yapılandırmayı tamamlamak için yalnızca AccessKey ID, AccessKey secret ve bölge kimliğini girmeniz yeterlidir. Daha fazla esneklik sağlamak amacıyla birden fazla yapılandırma dosyası belirtmek için --profile parametresini de kullanabilirsiniz.
Daha fazla filtre parametresi: ls, cp ve rm gibi toplu işleme komutları için yol, dosya boyutu, değiştirme zamanı ve nesne meta verilerine dayalı çeşitli filtre koşullarını destekler. Bu destek, işlemlerin doğruluğunu ve verimliliğini büyük ölçüde artırır.
Esnek çıkış biçimleri: --output-format parametresi, farklı veri işleme gereksinimlerini karşılamak üzere çıkış biçimini JSON, YAML veya XML olarak ayarlamanıza olanak tanır. --output-query seçeneği ise gerekli bilgileri almak için çıkışı filtrelemenizi sağlar.
Gelişmiş güvenlik: Güvenliği artırmak için ossutil 2,0, hassas parametrelerin ortam değişkenleri kullanılarak ayarlanmasına olanak tanır. Bu sayede anahtarların komut satırında açığa çıkması önlenir ve veri sızıntısı riski azaltılır. Ayrıca, --dry-run seçeneği, bir komutu çalıştırmadan önce davranışını doğrulamanızı sağlayarak istenmeyen işlemlerin gerçekleşmesini engeller.

Sürümler

Geçerli sürüm: 1.7.19
Önceki sürümler: Önceki ossutil sürümlerinin kaynak kodu ve sürüm geçmişi hakkında daha fazla bilgi için bkz. GitHub.

İndirme bağlantıları

İndirme bağlantısı	SHA-256 sağlama toplamı
Linux x86 32-bit	f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86
Linux x86 64-bit	dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343
Linux ARM 32-bit	ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d
Linux ARM 64-bit	f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57
macOS 64-bit	9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe
macOS ARM 64-bit	10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5
Windows x86 32-bit	772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799
Windows x86 64-bit	8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

ossutil'i indirin ve yükleyin

Linux

ossutil'i yükleyin.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Not
- Kurulumdan önce ossutil paketini arşivden çıkarmalısınız. unzip veya 7z gibi bir arşiv açma aracının yüklü olduğundan emin olun.
- Varsayılan olarak ossutil /usr/bin/ dizinine yüklenir.

ossutil'i yapılandırın.

Yapılandırma komutunu girin.
```
ossutil config
```
İstendiğinde yapılandırma dosyasının yolunu ayarlayın.
```
Please enter the config file name. The file name can include a path. (Default: /home/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Varsayılan olarak ossutil, yapılandırma dosyasını /home/user/.ossutilconfig konumuna kaydeder. Yapılandırma dosyası için farklı bir yol belirtirseniz, her ossutil komutunu çalıştırdığınızda yapılandırma dosyasını belirtmek üzere -c seçeneğini eklemeniz gerekir. Örneğin, yapılandırma dosyasını /home/config konumuna kaydederseniz ls komutunu aşağıdaki biçimde ve -c seçeneğini dahil ederek çalıştırın:
```
ossutil ls oss://examplebucket -c /home/config
```
İstendiğinde araç için dili ayarlayın. Çince için CH veya İngilizce için EN girin. Varsayılan olarak araç, işletim sisteminizin dilini kullanır. Bu ayar, config komutu başarıyla çalıştırıldıktan sonra etkinleşir.
Araç için dili ayarlayın.

CH veya EN girin. Varsayılan olarak araç, işletim sisteminizle aynı dili kullanır. Bu yapılandırma, config komutunu çalıştırdıktan sonra etkinleşir.

İstendiğinde Endpoint, AccessKey ID, AccessKey secret ve STSToken parametrelerini ayarlayın. STSToken parametresi yalnızca OSS'e erişmek için Security Token Service (STS) geçici kimlik bilgilerini kullandığınızda gereklidir. Aksi takdirde bu parametreyi boş bırakın.

Parametreler aşağıda açıklanmıştır:

Parametre	Gerekli	Açıklama
endpoint	Evet	Paketinizin bulunduğu bölgenin uç noktasını girin. Örneğin, bölgesi için genel uç noktayı olarak veya Singapore bölgesi için `https://oss-ap-southeast-1.aliyuncs.com` olarak ayarlayın. Aynı bölgedeki diğer Alibaba Cloud hizmetlerinden OSS'e erişmek için veya `https://oss-ap-southeast-1-internal.aliyuncs.com` gibi bir dahili uç nokta kullanın. Her bölgenin uç noktaları hakkında daha fazla bilgi için bkz. Bölgeler ve uç noktalar. Önemli Uyumluluğu ve güvenliği artırmak amacıyla yapılan bir ilke değişikliği nedeniyle, 20 Mart 2025 tarihinden itibaren yeni OSS kullanıcılarının, Çin anakarasındaki bölgelerde bulunan OSS paketlerinde veri API işlemleri gerçekleştirmek için bir özel alan adı (CNAME) kullanması gerekmektedir. Bu işlemler için varsayılan genel uç noktalar kısıtlanmıştır. Etkilenen işlemlerin tam listesi için resmi duyuruya bakın. Verilerinize HTTPS üzerinden erişiyorsanız, özel alan adınıza geçerli bir SSL Sertifikası bağlamanız gerekir. Konsol HTTPS'yi zorunlu kıldığından bu durum, OSS Konsolu erişimi için zorunludur.
accessKeyID	Evet	Hesabınızın AccessKey çiftini girin. AccessKey çiftini nasıl alacağınız hakkında daha fazla bilgi için bkz. AccessKey çifti oluşturun. OSS yönetim izinlerine sahip bir RAM kullanıcısı için ROS betiği kullanarak hızlıca AccessKey çifti oluşturun Resource Orchestration Service (ROS) konsolunun Create Stack sayfasında, Security Confirmation bölümündeki onay kutusunu seçin ve ardından Create öğesine tıklayın. Daha fazla bilgi için bkz. Yığın oluşturun. Yığın oluşturulduktan sonra, oluşturulan AccessKey çiftini Outputs sekmesinden kopyalayın. Çıktı listesinde AccessKeySecret ve AccessKeyId olmak üzere iki çıktı öğesi bulunur. İlgili değerleri sırasıyla kopyalayın.
accessKeySecret	Evet
stsToken	Hayır	Bu parametre yalnızca OSS'e erişmek için geçici erişim kimlik bilgilerini kullandığınızda gereklidir. Aksi takdirde bu parametreyi boş bırakın. STS belirteci oluşturma hakkında daha fazla bilgi için bkz. AssumeRole.

ossutil'in yüklendiğini doğrulayın.
```
ossutil
```
Desteklenen ossutil komutlarının bir listesi görüntülenirse kurulum başarılı olmuştur.

Windows

ossutil'i yükleyin.
1. Windows yükleme paketini indirmek için indirme bağlantısına tıklayın.
2. Paketi arşivden çıkarın ve ossutil.bat dosyasına çift tıklayın.

ossutil'i yapılandırın.

Yapılandırma komutunu girin.
```
ossutil config
```
İstendiğinde yapılandırma dosyası için yolu ayarlayın.
```
Please enter the config file name. The file name can include a path. (Default: C:\\Users\user\.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Varsayılan olarak ossutil, yapılandırma dosyasını C:\\Users\user\.ossutilconfig konumuna kaydeder. Yapılandırma dosyası için farklı bir yol belirtirseniz, her komutu çalıştırdığınızda yapılandırma dosyasını belirtmek üzere -c seçeneğini eklemeniz gerekir. Örneğin, yapılandırma dosyası c:\ossutil\config konumuna kaydedilirse ls komutunu aşağıdaki biçimde çalıştırın:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
İstendiğinde araç için dili ayarlayın. Çince için CH veya İngilizce için EN girin. Varsayılan olarak araç, işletim sisteminizin dilini kullanır. Bu yapılandırma, config komutunu çalıştırdıktan sonra etkinleşir.

İstendiğinde Endpoint, AccessKey ID, AccessKey secret ve STSToken parametrelerini ayarlayın. STSToken parametresi yalnızca OSS'e erişmek için STS geçici kimlik bilgilerini kullandığınızda gereklidir. Aksi takdirde bu parametreyi boş bırakın.

Aşağıdaki tabloda parametreler açıklanmaktadır.

Parametre	Gerekli	Açıklama
endpoint	Evet	Paketinizin bulunduğu bölgenin uç noktasını girin. Örneğin, bölgesi için genel uç noktayı olarak veya Singapore bölgesi için `https://oss-ap-southeast-1.aliyuncs.com` olarak ayarlayın. Aynı bölgedeki diğer Alibaba Cloud hizmetlerinden OSS'e erişmek için veya `https://oss-ap-southeast-1-internal.aliyuncs.com` gibi bir dahili uç nokta kullanın. Her bölgenin uç noktaları hakkında daha fazla bilgi için bkz. Bölgeler ve uç noktalar. Önemli Uyumluluğu ve güvenliği artırmak amacıyla yapılan bir ilke değişikliği nedeniyle, 20 Mart 2025 tarihinden itibaren yeni OSS kullanıcılarının, Çin anakarasındaki bölgelerde bulunan OSS paketlerinde veri API işlemleri gerçekleştirmek için bir özel alan adı (CNAME) kullanması gerekmektedir. Bu işlemler için varsayılan genel uç noktalar kısıtlanmıştır. Etkilenen işlemlerin tam listesi için resmi duyuruya bakın. Verilerinize HTTPS üzerinden erişiyorsanız, özel alan adınıza geçerli bir SSL Sertifikası bağlamanız gerekir. Konsol HTTPS'yi zorunlu kıldığından bu durum, OSS Konsolu erişimi için zorunludur.
accessKeyID	Evet	Hesabınızın AccessKey çiftini girin. AccessKey çiftini nasıl alacağınız hakkında daha fazla bilgi için bkz. AccessKey çifti oluşturun. OSS yönetim izinlerine sahip bir RAM kullanıcısı için ROS betiği kullanarak hızlıca AccessKey çifti oluşturun Resource Orchestration Service (ROS) konsolunun Create Stack sayfasında, Security Confirmation bölümündeki onay kutusunu seçin ve ardından Create öğesine tıklayın. Daha fazla bilgi için bkz. Yığın oluşturun. Yığın oluşturulduktan sonra, oluşturulan AccessKey çiftini Outputs sekmesinden kopyalayın. Çıktı anahtar kelimeleri arasında AccessKeyId ve AccessKeySecret bulunur. İlgili değerleri sırasıyla kopyalayın ve güvenli bir yerde saklayın.
accessKeySecret	Evet
stsToken	Hayır	Bu parametre yalnızca OSS'e erişmek için geçici erişim kimlik bilgilerini kullandığınızda gereklidir. Aksi takdirde bu parametreyi boş bırakın. STS belirteci oluşturma hakkında daha fazla bilgi için bkz. AssumeRole.

ossutil'in yüklendiğini doğrulayın.
```
ossutil
```
Desteklenen ossutil komutlarının bir listesi görüntülenirse kurulum başarılı olmuştur.

macOS

ossutil'i yükleyin.

sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash

Not

Varsayılan yükleme dizini /usr/local/bin'dir.

ossutil'i yapılandırın.

Yapılandırma komutunu girin.
```
ossutil config
```
İstendiğinde yapılandırma dosyası için yolu ayarlayın.
```
Please enter the config file name. The file name can include a path. (Default: /Users/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Varsayılan olarak ossutil, yapılandırma dosyasını /Users/user/.ossutilconfig konumuna kaydeder.

Yapılandırma dosyası için farklı bir yol belirtirseniz, her komutu çalıştırdığınızda yapılandırma dosyasını belirtmek üzere -c seçeneğini eklemeniz gerekir. Örneğin, yapılandırma dosyası /home/config konumuna kaydedilirse ls komutunu aşağıdaki biçimde çalıştırın:
```
ossutil ls oss://examplebucket -c /home/config
```
İstendiğinde araç için dili ayarlayın. Çince için CH veya İngilizce için EN girin. Varsayılan olarak araç, işletim sisteminizin dilini kullanır. Bu yapılandırma, config komutunu çalıştırdıktan sonra etkinleşir.

Aşağıdaki tabloda parametreler açıklanmaktadır.

Parametre	Gerekli	Açıklama
endpoint	Evet	Paketinizin bulunduğu bölgenin uç noktasını girin. Örneğin, bölgesi için genel uç noktayı olarak veya Singapore bölgesi için `https://oss-ap-southeast-1.aliyuncs.com` olarak ayarlayın. Aynı bölgedeki diğer Alibaba Cloud hizmetlerinden OSS'e erişmek için veya `https://oss-ap-southeast-1-internal.aliyuncs.com` gibi bir dahili uç nokta kullanın. Her bölgenin uç noktaları hakkında daha fazla bilgi için bkz. Bölgeler ve uç noktalar. Önemli Uyumluluğu ve güvenliği artırmak amacıyla yapılan bir ilke değişikliği nedeniyle, 20 Mart 2025 tarihinden itibaren yeni OSS kullanıcılarının, Çin anakarasındaki bölgelerde bulunan OSS paketlerinde veri API işlemleri gerçekleştirmek için bir özel alan adı (CNAME) kullanması gerekmektedir. Bu işlemler için varsayılan genel uç noktalar kısıtlanmıştır. Etkilenen işlemlerin tam listesi için resmi duyuruya bakın. Verilerinize HTTPS üzerinden erişiyorsanız, özel alan adınıza geçerli bir SSL Sertifikası bağlamanız gerekir. Konsol HTTPS'yi zorunlu kıldığından bu durum, OSS Konsolu erişimi için zorunludur.
accessKeyID	Evet	Hesabınızın AccessKey çiftini girin. AccessKey çiftini nasıl alacağınız hakkında daha fazla bilgi için bkz. AccessKey çifti oluşturun. OSS yönetim izinlerine sahip bir RAM kullanıcısı için ROS betiği kullanarak hızlıca AccessKey çifti oluşturun Resource Orchestration Service (ROS) konsolunun Create Stack sayfasında, Security Confirmation bölümündeki onay kutusunu seçin ve ardından Create öğesine tıklayın. Daha fazla bilgi için bkz. Yığın oluşturun. Yığın oluşturulduktan sonra, oluşturulan AccessKey çiftini Outputs sekmesinden kopyalayın. Çıktı anahtar kelimeleri arasında AccessKeyId ve AccessKeySecret bulunur. İlgili değerleri sırasıyla kopyalayın ve güvenli bir yerde saklayın.
accessKeySecret	Evet
stsToken	Hayır	Bu parametre yalnızca OSS'e erişmek için geçici erişim kimlik bilgilerini kullandığınızda gereklidir. Aksi takdirde bu parametreyi boş bırakın. STS belirteci oluşturma hakkında daha fazla bilgi için bkz. AssumeRole.

ossutil'in yüklendiğini doğrulayın.
```
ossutil
```
Desteklenen ossutil komutlarının bir listesi görüntülenirse kurulum başarılı olmuştur.

Başvurular

ossutil'i yükledikten sonra nesneleri yüklemek, indirmek, kopyalamak ve silmek için kullanabilirsiniz. Daha fazla bilgi için bkz. cp (nesneleri yükleyin), cp (nesneleri indirin), cp (nesneleri kopyalayın) ve rm (nesneleri silin).