OSS'de bir hedef nesneyi işaret eden sembolik bağlantı (symlink) oluşturur. Hedef nesneye erişmek için bu sembolik bağlantıyı kullanabilirsiniz.
Kullanım notları
PutSymlink, hedef nesnenin var olup olmadığını, depolama sınıfının geçerli olup olmadığını veya buna erişim izninizin bulunup bulunmadığını doğrulamaz.
Sembolik bağlantının ve hedef nesnenin Erişim Kontrol Listesi (ACL) yalnızca GetObject gibi işlemler hedef nesneye eriştiğinde kontrol edilir.
x-oss-meta- önekiyle başlayan istek üst bilgileri, sembolik bağlantının kullanıcı meta verileri olarak saklanır. Örnek: x-oss-meta-location. Birden fazla meta veri üst bilgisi belirtebilirsiniz ancak toplam meta veri boyutu 8 KB'yi aşamaz.
Varsayılan olarak, aynı ada sahip bir nesne varsa ve erişim izniniz bulunuyorsa yeni nesne mevcut olanın üzerine yazar. OSS 200 OK yanıtını döndürür.
Sürüm Oluşturma
Sembolik bağlantı, hedef nesnenin geçerli sürümünü işaret eder.
Bir sembolik bağlantının birden çok sürümü olabilir ve her biri farklı bir nesneyi işaret edebilir. OSS sürüm kimlikleri oluşturur ve bunları x-oss-version-id yanıt üst bilgisinde döndürür.
İzinler
Varsayılan olarak bir Alibaba Cloud hesabı tam izinlere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.
|
API |
Action |
Description |
|
PutSymlink |
|
Bir nesne için sembolik bağlantı oluşturur. |
|
|
Bir nesne için sembolik bağlantı oluştururken x-oss-tagging aracılığıyla nesne etiketleri belirtiyorsanız bu izin gereklidir. |
İstek sözdizimi
PUT /ObjectName?symlink HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-symlink-target: TargetObjectName
İstek üst bilgileri
|
Header |
Type |
Required |
Description |
|
x-oss-forbid-overwrite |
String |
No |
Aynı ada sahip mevcut bir nesnenin üzerine yazılmasını önleyip önlemeyeceğinizi belirtir.
Bu üst bilginin belirtilmesi QPS performansını düşürebilir. QPS değerinizin 1.000'i aşması durumunda teknik destekle iletişime geçin. Not
Pakette sürüm oluşturma etkinleştirildiğinde veya askıya alındığında bu üst bilgi etkili olmaz. PutSymlink her durumda nesnenin üzerine yazar. |
|
x-oss-symlink-target |
String |
Yes |
Sembolik bağlantının işaret ettiği hedef nesne. Nesne adlandırma kurallarıyla aynı kuralları izler.
|
|
x-oss-object-acl |
String |
No |
Nesnenin ACL'si. Varsayılan değer: default. Geçerli değerler:
Nesne ACL'leri hakkında daha fazla bilgi için bkz. Nesne ACL'leri. |
|
x-oss-storage-class |
String |
No |
Nesnenin depolama sınıfı. Belirtildiğinde paketin varsayılan depolama sınıfını geçersiz kılar. Örneğin, IA paketine yüklerken bunu Standard olarak ayarlamak nesneyi Standard olarak depolar. Geçerli değerler:
IA ve Archive nesneleri için minimum faturalandırılabilir boyut 64 KB'dir. Sembolik bağlantılar için depolama sınıfını IA veya Archive olarak ayarlamaktan kaçının. Depolama sınıfı ayrıntıları: Genel Bakış. |
PutSymlink isteğine dahil edilen Host ve Date gibi ortak istek üst bilgileri hakkında daha fazla bilgi için bkz. Ortak istek üst bilgileri.
Yanıt üst bilgileri
PutSymlink isteğine verilen yanıt yalnızca ortak yanıt üst bilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.
Örnekler
-
Örnek istekler
PUT /link-to-oss.jpg?symlink HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Cache-control: no-cache Content-Disposition: attachment;filename=oss_download.jpg Date: Tue, 08 Nov 2016 02:00:25 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-disposition,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e x-oss-symlink-target: oss**** x-oss-storage-class: StandardBaşarılı yanıt örnekleri
HTTP/1.1 200 OK Server: AliyunOSS Date: Tue, 08 Nov 2016 02:00:25 GMT Content-Length: 0 Connection: keep-alive x-oss-request-id: 582131B9109F4EE66CDE56A5 ETag: "0A477B89B4602AA8DECB8E19BFD4****" -
Sürüm oluşturulmuş paket için örnek istekler
PUT /link-to-oss.jpg?symlink HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 09 Apr 2019 06:50:48 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e x-oss-symlink-target: oss.jpgBaşarılı yanıt örnekleri
HTTP/1.1 200 OK Server: AliyunOSS Date: Tue, 09 Apr 2019 06:50:48 GMT Content-Length: 0 Connection: keep-alive x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** x-oss-request-id: 5CAC40C8B7AEADE01700064B ETag: "136A5E127272200EDAB170DD84DE****"
OSS SDK'ları
Aşağıdaki OSS SDK'ları PutSymlink işlemini destekler:
ossutil
PutSymlink işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-symlink.
Hata kodları
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|