PutBucketReferer - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

İzinler

Varsayılan olarak Alibaba Cloud hesabı tüm izinlere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rollerinde varsayılan olarak herhangi bir izin bulunmaz. Alibaba Cloud hesabı veya hesap yöneticisi, RAM ilkeleri veya Paket İlkesi aracılığıyla işlem izinleri vermelidir.

İstek sözdizimi

PUT /?referer HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
    <Referer>https://www.aliyun.com</Referer>
    <Referer>http://www.*.com</Referer>
    <Referer>https://www.?.aliyuncs.com</Referer>
  </RefererList>
  <RefererBlacklist>
    <Referer>http://www.refuse.com</Referer>
    <Referer>https://*.hack.com</Referer>
    <Referer>http://ban.*.com</Referer>
    <Referer>https://www.?.deny.com</Referer>
  </RefererBlacklist>
</RefererConfiguration>

İstek öğeleri

Öğe	Tür	Gerekli	Örnek	Açıklama
RefererConfiguration	Konteyner	Evet	Yok	Hotlink koruma yapılandırmalarını depolayan konteyner. Alt düğümler: AllowEmptyReferer, AllowTruncateQueryString ve RefererList Üst düğümler: yok
AllowEmptyReferer	Numaralandırılmış dize	Evet	false	Referer alanı boş olan bir isteğe izin verilip verilmeyeceğini belirtir. Geçerli değerler: true (varsayılan) false Üst düğümler: RefererConfiguration
AllowTruncateQueryString	Numaralandırılmış dize	Hayır	true	Referer eşleştiğinde URL'deki sorgu dizesinin kırpılıp kırpılmayacağını belirtir. Geçerli değerler: true false (varsayılan) Üst düğümler: RefererConfiguration
TruncatePath	Numaralandırılmış dize	Hayır	true	Referer eşleştiğinde URL'deki yolun ve yoldan sonraki kısımların kırpılıp kırpılmayacağını belirtir. Geçerli değerler: true Önemli TruncatePath true olarak ayarlanırsa sorgu dizesi yol bileşenini takip ettiğinden AllowTruncateQueryString değeri de true olmalıdır. Yol kırpıldığında sorgu dizesi de kırpılır. false (varsayılan) Üst düğümler: RefererConfiguration
RefererList	Konteyner	Evet	Yok	Referer izin listesini depolayan konteyner. Not PutBucketReferer işlemi mevcut Referer izin listesini RefererList içinde belirtilen Referer izin listesiyle değiştirir. İstek içinde RefererList belirtilmezse (hiçbir Referer öğesinin dahil edilmediği anlamına gelir) PutBucketReferer işlemi mevcut Referer izin listesini temizler. Üst düğümler: RefererConfiguration Alt düğümler: Referer
RefererBlacklist	Konteyner	Hayır	Yok	Referer engelleme listesini depolayan konteyner. Not PutBucketReferer işlemi mevcut Referer engelleme listesini RefererBlacklist içinde belirtilen Referer engelleme listesiyle değiştirir. İstek içinde RefererBlacklist belirtilmezse (hiçbir Referer öğesinin dahil edilmediği anlamına gelir) PutBucketReferer işlemi mevcut Referer engelleme listesini temizler. Üst düğümler: RefererConfiguration Alt düğümler: Referer
Referer	Dize	Hayır	http://www.aliyun.com	Referer izin listesindeki veya engelleme listesindeki adresler. Üst düğümler: RefererList veya RefererBlacklist

PutBucketReferer işlemindeki Host ve Date gibi ortak istek üstbilgileri hakkında daha fazla bilgi için bkz. Ortak istek üstbilgileri.

Yanıt üstbilgileri

Bir PutBucketReferer isteğine verilen yanıtta yer alan tüm üstbilgiler ortak yanıt üstbilgeleridir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

Örnek istekler

Referer izin listesi veya Referer engelleme listesi içermeyen örnek istek

PUT /?referer HTTP/1.1
Host: BucketName.oss.example.com
Content-Length: 247
Date: Thu, 17 Apr 2025 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  <RefererList/>
</RefererConfiguration>

Yalnızca Referer izin listesi içeren örnek istek

PUT /?referer HTTP/1.1
Host: BucketName.oss.example.com
Content-Length: 247
Date: Thu, 17 Apr 2025 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
    <Referer>https://www.aliyun.com</Referer>
    <Referer>http://www.*.com</Referer>
    <Referer>https://www.?.aliyuncs.com</Referer>
  </RefererList>
</RefererConfiguration>

Referer izin listesi ve Referer engelleme listesi içeren örnek istek

PUT /?referer HTTP/1.1
Host: BucketName.oss.example.com
Content-Length: ***
Date: Thu, 17 Apr 2025 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
    <Referer>https://www.aliyun.com</Referer>
    <Referer>http://www.*.com</Referer>
    <Referer>https://www.?.aliyuncs.com</Referer>
  </RefererList>
  <RefererBlacklist>
    <Referer>http://www.refuse.com</Referer>
    <Referer>https://*.hack.com</Referer>
    <Referer>http://ban.*.com</Referer>
    <Referer>https://www.?.deny.com</Referer>
  </RefererBlacklist>
</RefererConfiguration>

Örnek yanıt

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-server-time: 110

OSS SDK'ları

PutBucketReferer işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

PutBucketReferer işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-bucket-referer.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
AccessDenied	403	PutBucketReferer işlemini gerçekleştirme yetkiniz yok. Yalnızca paket sahibi PutBucketReferer isteklerini başlatabilir.
InvalidDigest	400	OSS tarafından hesaplanan ileti gövdesinin Content-MD5 değeri, istek üstbilgisindeki Content-MD5 değeri ile tutarsızdır. Content-MD5 istek üstbilgisi yüklendikten sonra OSS, ileti gövdesine göre MD5 hash değerini hesaplar ve hesaplanan MD5 hash değerinin istek üstbilgisinde belirtilen Content-MD5 değeri ile aynı olup olmadığını kontrol eder. MD5 hash değerleri tutarsızsa bu hata kodu döndürülür.
InlineDataTooLarge	400	Referer izin listesi ve engelleme listesi 20 KB'lık üst sınırı aşıyor. Referer izin listesi ve engelleme listesindeki girişleri azaltın.

API	Eylem	Açıklama
PutBucketReferer	oss:PutBucketReferer	Paket için hotlink korumasını yapılandırır.