Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:PutSymlink

Son Güncelleme:Oct 01, 2026

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

oss:PutObject

Bir nesne için sembolik bağlantı oluşturur.

oss:PutObjectTagging

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.

  • Belirtilmemişse veya false olarak ayarlanmışsa: Mevcut nesnenin üzerine yazılır.

  • true olarak ayarlanmışsa: Mevcut nesnenin üzerine yazılamaz.

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.

  • TargetObjectName, ObjectName ile aynı şekilde URL kodlamasına tabi tutulmalıdır.

  • Hedef nesne bir sembolik bağlantı olamaz.

x-oss-object-acl

String

No

Nesnenin ACL'si. Varsayılan değer: default.

Geçerli değerler:

  • default: Paket ACL'sini devralır.

  • private: Nesneyi yalnızca sahibi ve yetkili kullanıcılar okuyup yazabilir.

  • public-read: Tüm kullanıcılar nesneyi okuyabilir. Nesneyi yalnızca sahibi ve yetkili kullanıcılar yazabilir. Dikkatli kullanın.

  • public-read-write: Tüm kullanıcılar nesneyi okuyup yazabilir. Dikkatli kullanın.

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:

  • Standard

  • IA

  • Archive

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: Standard

    Baş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.jpg

    Baş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ı


Error code


HTTP status code


Description


InvalidArgument


400


StorageClass değeri geçersiz.


FileAlreadyExists


409


Aynı ada sahip bir nesne mevcut ve x-oss-forbid-overwrite true olarak ayarlanmış.


FileImmutable


409


Nesne bir bekletme ilkesi tarafından korunuyor.