Object Storage Service (OSS) paketindeki bir nesnenin erişim kontrol listesi (ACL) varsayılan olarak özeldir. Yalnızca nesne sahibi nesneye erişim iznine sahiptir. Ancak, nesne sahibi sign komutunu çalıştırarak üçüncü taraf kullanıcılarla paylaşmak üzere nesne için imzalı bir URL oluşturabilir. İmzalı URL, erişim kimlik bilgileri kullanılarak oluşturulur ve üçüncü taraf kullanıcıların belirtilen bir süre boyunca nesneyi indirmesine veya önizlemesine izin verir.
Diğer kullanıcılar, nesnenin imzalı URL'sini kullanarak nesneye erişebilir. Bu erişim, nesnenin ACL'sinin public-read veya private olup olmadığına ya da bir paket ilkesinin veya RAM ilkesinin kullanıcıya erişim izni verip vermediğine bakılmaksızın sağlanır.
ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak
ossutilkullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemenize gerek yoktur. 1.6.16'dan önceki ossutil sürümlerinde, işletim sistemiyle eşleşen bir ikili dosya adı belirtmeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.
Komut biçimi
ossutil sign cloud_url
[--timeout <value>]
[--version-id <value>]
[--trafic-limit <value>]
[--disable-encode-slash]
[--payer <value>]
[--query-param <value>]Aşağıdaki tabloda parametreler ve seçenekler açıklanmaktadır.
|
Yapılandırma Öğesi |
Açıklama |
|
cloud_url |
OSS paketindeki nesnenin tam yolu. |
|
--timeout |
İmzalı URL'nin saniye cinsinden sona erme süresi. Varsayılan değer: 60. Önemli
Geçerli UNIX zaman damgası ile sona erme süresinin toplamı 9223372036854775807 değerini aşamaz. Aksi takdirde taşma hatası oluşur. Örneğin, geçerli UNIX zaman damgası 1643341269 ise maksimum sona erme süresi 9223372035211434538 değerini aşmamalıdır. |
|
--version-id |
Nesnenin sürüm kimliği. Bu parametre yalnızca sürüm oluşturmanın etkinleştirildiği veya askıya alındığı paketlerdeki nesneler için geçerlidir. |
|
--trafic-limit |
bit/s cinsinden HTTP erişimi için hız sınırı. Varsayılan değer, sınır olmadığını belirten 0'dır. Değer, 100 KB/s ile 100 MB/s'ye eşdeğer olan 819200 ile 838860800 arasında olmalıdır. |
|
--disable-encode-slash |
cloud_url içindeki eğik çizgileri (/) kodlamayın. |
|
--payer |
İstek için ödeme yöntemi. Kaynaklara erişim sırasında oluşan trafiğin ve isteklerin ücretini talep eden kişinin ödemesini sağlamak için bu seçeneği requester olarak ayarlayın. |
|
--query-param |
İstekteki sorgu parametreleri. Bu parametre birden çok kez belirtilebilir. Örneğin, görüntü işleme için bu parametreyi ayarlayabilirsiniz. --query-param için desteklenen parametreler şunlardır: x-oss-process, x-oss-traffic-limit, response-content-language, response-expires, response-cache-control, response-content-disposition, response-content-encoding, x-oss-ac-source-ip, x-oss-ac-subnet-mask, x-oss-ac-vpc-id ve x-oss-ac-forward-allow. Parametreler hakkında daha fazla bilgi için bkz. Signature V1 ve GetObject. Not
--query-param parametresi yalnızca ossutil 1.7.15 ve sonraki sürümlerde desteklenir. |
Örnekler
-
examplebucket paketindeki exampleobject.png nesnesi için imzalı bir URL oluşturun. Varsayılan zaman aşımı süresi 60 saniyedir.
ossutil sign oss://examplebucket/exampleobject.png -
examplebucket paketindeki exampleobject.png nesnesi için imzalı bir URL oluşturun ve zaman aşımı süresini 3600 saniye olarak ayarlayın.
ossutil sign oss://examplebucket/exampleobject.png --timeout 3600 -
examplebucket paketindeki exampleobject.png nesnesi için imzalı bir URL oluşturun, zaman aşımı süresini 7200 saniye olarak ayarlayın ve erişim hızını 100 MB/s ile sınırlayın.
ossutil sign oss://examplebucket/exampleobject.png --timeout 7200 --trafic-limit 838860800 -
Sürüm oluşturmanın etkinleştirildiği examplebucket paketindeki exampleobject.jpg nesnesinin belirli bir sürümü için imzalı bir URL oluşturun ve zaman aşımı süresini 1800 saniye olarak ayarlayın.
ossutil sign oss://examplebucket/exampleobject.jpg --timeout 1800 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** -
İşlenmiş bir görüntü için imzalı bir URL oluşturun. Bu komut, examplebucket paketindeki exampleobject.jpg görüntü nesnesini 100 × 100 piksele yeniden boyutlandırır ve 90 derece döndürür.
ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90 -
İşlenmiş bir görüntü için imzalı bir URL oluşturun. Bu komut, examplebucket paketindeki exampleobject.jpg görüntü nesnesini 100 × 100 piksele yeniden boyutlandırır, 90 derece döndürür ve erişim hızını 100 KB/s (819200 bit/s) ile sınırlar.
ossutil sign oss://examplebucket/exampleobject.jpg --query-param x-oss-process:image/resize,m_fixed,w_100,h_100/rotate,90 --query-param x-oss-traffic-limit:819200 -
Komut başarılı olursa çıktı, URL'nin oluşturulması için geçen süreyi, URL'nin sona erme zamanını ve imzayı içerir. Aşağıda örnek bir çıktı gösterilmektedir:
https://examplebucket.ss-cn-hangzhou.aliyuncs.com/exampleobject.png?Expires=1608282224&OSSAccessKeyId=LTAI****************&Signature=jo4%**************************** 0.368676(s) elapsed
Ortak seçenekler
Farklı bir bölgedeki bir pakete erişmek için uç noktayı belirtmek amacıyla -e seçeneğini kullanın. Farklı bir Alibaba Cloud hesabına ait bir pakete erişmek için AccessKey ID için -i ve AccessKey secret için -k seçeneklerini kullanın.
Örneğin, aşağıdaki komutu çalıştırarak exampletest.jpg nesnesi için imzalı bir URL oluşturun ve zaman aşımı süresini 3600 saniye olarak ayarlayın. Nesne, Çin (Şanghay) bölgesinde bulunan ve başka bir Alibaba Cloud hesabına ait olan testbucket paketindedir.
ossutil sign oss://testbucket/exampletest.jpg --timeout 3600 -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret